Datasheets.com · API v1

Product Search API Docs

Query the same ranking engine as the search page and get best-match parts and product data.

Quickstart

Server-to-Server Only

Endpoint

GET /api/v1/search

Auth

Authorization: Bearer api-key

Query Params

q required, limit optional (default 5, max 10), page optional (default 1)

Default Rate Limits

60/min · 500/hour · 5,000/month (adjustable per user)

Usage Terms

Attribution Required

Keep API keys on your own server-side systems and do not expose them publicly.
Do not use the API or the Site to scrape, mirror, bulk-download, or interfere with Datasheets.com infrastructure.
Do not use API responses to publish Datasheets.com data publicly on another website, application, or service without our permission and attribution.
If you want to show product information publicly, use the Datasheets.com widget or link users back to Datasheets.com.

API use is subject to our Terms & Conditions. If you need higher limits or broader rights, contact [email protected]. Any expanded access is governed by a separate agreement when one exists.

Sample Request

curl -sS "https://www.datasheets.com/api/v1/search?q=bav99&limit=10&page=1" \
  -H "Authorization: Bearer api-key"

const response = await fetch(
  'https://www.datasheets.com/api/v1/search?q=bav99&limit=10&page=1',
  {
    headers: {
      Authorization: 'Bearer api-key',
    },
  }
);

const data = await response.json();
console.log(data.results[0].specs);

Sample Response

{
  "query": "bav99",
  "page": 1,
  "limit": 10,
  "count": 1,
  "results": [
    {
      "mpn": "BAV99",
      "manufacturer": "Onsemi",
      "title": "70V 200mA SOT-23 Ultra-Fast Switching Diode",
      "description": "Ultra-fast switching diode with 70V reverse voltage and 200mA average rectified current. Features 1.5pF capacitance and 6ns reverse recovery time.",
      "url": "https://www.datasheets.com/onsemi/bav99",
      "category1": "Semiconductors",
      "category2": "Discrete Semiconductors",
      "category3": "Diodes",
      "category4": "General Purpose Rectifiers",
      "packageType": "R-PDSO-G3",
      "lifecycleStatus": "Obsolete",
      "datasheetUrl": "https://static.datasheets.com/doc/22607381-onsemi-bav99-ds.pdf",
      "primaryImageUrl": "https://static.datasheets.com/image/22607381-onsemi-bav99-image.png",
      "specs": [
        { "name": "Average Rectified Current", "value": "200mA" },
        { "name": "Capacitance", "value": "1.5pF" },
        { "name": "Reverse Recovery Time", "value": "6ns" }
      ]
    }
  ]
}

Errors

400 invalid query/limit/page
401 missing or invalid key
429 rate limit exceeded
500 internal search failure
503 ClickHouse unavailable (fail-closed)

Rate Headers

X-RateLimit-Limit-Minute
X-RateLimit-Limit-Hour
X-RateLimit-Limit-Month
X-RateLimit-Remaining-Minute
X-RateLimit-Remaining-Hour
X-RateLimit-Remaining-Month
Retry-After on 429