Datasheets Public Search API Skill
Prerequisite
-
Use runtime-managed credentials only, such as an authenticated tool profile, environment variable, or secret manager.
-
Never ask users to paste credentials into chat or store credentials in prompt context.
-
If auth is not configured, direct the user to https://www.datasheets.com/account/api and ask them to complete setup out of band before continuing.
API Reference
-
Base URL: https://www.datasheets.com
-
Endpoint: GET /api/v1/search
-
Auth: Bearer token authentication configured by the execution runtime (no inline secret values in instructions).
Query Parameters
Parameter Required Default Max Description
q
Yes n/a n/a Search query (MPN, keyword, or manufacturer)
limit
No 5
10
Results per page
page
No 1
n/a Page number
Response Shape
{ "query": "bav99", "page": 1, "limit": 5, "count": 42, "results": [] }
Rules
-
Only use GET /api/v1/search ; do not call other methods or endpoints
-
Never send credentials in query params (apiKey , api_key , etc.)
-
Never request, echo, or persist credential values from conversation context
-
Execute requests with preconfigured auth injection from runtime/tooling
-
Redact auth headers/tokens from logs and debug output
Error Handling
Code Meaning Action
400
Bad request Check query params
401
Unauthorized Ask user to verify/rotate credentials in account settings, then retry
429
Rate limited Check Retry-After and X-RateLimit-* headers
500
Server error Retry after a moment
503
Service unavailable Retry after a moment
Examples
See references/examples.md for full code examples in cURL, JavaScript, Python, and TypeScript.
Workflow
-
Validate and normalize q , limit , and page
-
If runtime auth is missing, send the user to https://www.datasheets.com/account/api and pause until configured
-
Construct the search URL with q , limit , and page
-
Execute GET /api/v1/search using the preconfigured authenticated client/tool
-
Parse and display the results array in a readable format
-
If count exceeds limit , offer to paginate