fetchbean quickstart: make your first API call

Create an API key, call the curated POST /v1/search endpoint, then use POST /v1/run to execute a registered provider operation.

Create an API key

Sign in at fetchbean.com/app and open the API Keys section. Click Create key, give it a name, and copy the value immediately — it starts with fb_ and is shown only once. Store it as the environment variable FETCHBEAN_KEY so it stays out of your source code.

Call a curated tool

Curated tools return the same clean, normalized JSON shape every time, regardless of which provider powers them. Use POST /v1/search to run a web search:

curl https://api.fetchbean.com/v1/search \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best vector databases"}'

const res = await fetch('https://api.fetchbean.com/v1/search', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.FETCHBEAN_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ query: 'best vector databases' })
});
const data = await res.json();
console.log(data.results);

import httpx, os
res = httpx.post(
    'https://api.fetchbean.com/v1/search',
    headers={'X-API-Key': os.environ["FETCHBEAN_KEY"]},
    json={'query': 'best vector databases'}
)
print(res.json()['results'])

A successful search returns results in this shape:

{
  "results": [
    { "title": "Qdrant", "url": "https://qdrant.tech", "snippet": "..." },
    { "title": "Weaviate", "url": "https://weaviate.io", "snippet": "..." }
  ]
}

Call a registered provider operation

Use POST /v1/run with a provider and endpoint from the catalog. fetchbean validates input against the operation’s schema and returns its provider-specific result without applying the curated normalization layer:

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"exa","endpoint":"/search","input":{"query":"best vector databases","numResults":10}}'

Provider failures and timeouts are billed at zero. Some other failures can be billable when the upstream call succeeded, so check the error envelope’s billable field. See Errors and Credits.

Get Started

Core Concepts

Guides

Reference

fetchbean quickstart: make your first API call

Next steps

Credits & billing

Authentication

​Next steps

Credits & billing

Authentication

Next steps