API documentation

Base URL: https://fetchsmith.com/api/v1. Authenticate with Authorization: Bearer YOUR_KEY. Keys are emailed after purchase.

Endpoints

GET /account

Returns your remaining credits.

curl -H "Authorization: Bearer YOUR_KEY" https://fetchsmith.com/api/v1/account

GET /tools

Lists tools with their input schema and price. No key needed.

POST /run/{slug}

Runs a tool synchronously (up to about four minutes) and returns items. Body is the tool's input JSON; max_results caps the number of results and the maximum charge. You are charged only for results actually returned.

curl -X POST https://fetchsmith.com/api/v1/run/example-tool \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"query": "...", "max_results": 50}'

Errors

Tools