Quickstart

Get up and running with the Zenode API in under 5 minutes. By the end you'll have a working request that searches for electronic parts.

Get your API key

Sign up at zenode.ai and go to Dashboard → API Keys to create your first key.

Free tier

Every new account starts with $5 of free usage — no credit card required.

All API keys are prefixed with zn_. They are shown only once at creation time, so copy it somewhere safe before closing the dialog.

Search by MPN

The fastest way to find a part is to search by its manufacturer part number (MPN). Send a GET to /v1/parts/search with your mpn query parameter:

curl "https://api.zenode.ai/v1/parts/search?mpn=LM358&limit=5" \
  -H "Authorization: Bearer zn_your_api_key"

A successful response looks like:

{
  "hits": 5,
  "results": [
    {
      "part": {
        "mpn": "LM358",
        "short_description": "Dual General-Purpose Op-Amp",
        "manufacturer": {
          "name": "Texas Instruments",
          "slug": "texas-instruments"
        }
      },
      "description": "LM358 – Low Power, Dual Op-Amp, DIP-8"
    }
  ],
  "warnings": []
}

Search by keyword

Use the agentic search endpoint for natural-language or keyword queries — useful when you don't have an exact MPN:

curl "https://api.zenode.ai/v1/parts/agentic-search?search_query=5V+LDO+regulator&limit=5" \
  -H "Authorization: Bearer zn_your_api_key"

When to use which endpoint

Use /v1/parts/search?mpn= when you have an exact part number. Use /v1/parts/agentic-search?search_query= for descriptions, keywords, or fuzzy matches.

Try GraphQL

The GraphQL API gives you precise control over which fields you fetch. Send a POST to /graphql:

curl -X POST https://api.zenode.ai/graphql \
  -H "Authorization: Bearer zn_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ supSearchMpn(mpn: \"LM358\", limit: 5) { hits results { description part { mpn manufacturer { name } } } } }"
  }'

Or open the interactive explorer at api.zenode.ai/graphql to build and run queries in your browser.

Next steps