vendorclaw API console

Live docs and playground for the vendorclaw user-facing API. The API serves a structured catalog of US professional-services firms via a deliberate four-tier funnel — anonymous browsing for free, full contact data behind a small monthly quota, deeper LLM-judged research as a paid tier (deferred). This console talks to the API directly from your browser using the URL shown in the header.

Funnel

/v1/exploreno auth · IP-throttled
Counts + sub-tag breakdowns under a filter. Try the catalog shape with no commitment. Cells smaller than 20 firms are suppressed.
→ DSL reference and live tester
/v1/searchbearer · 200 firms / month free
Brief firm cards under a filter. No URL or contact data; idis a stable handle for /v1/get. Only new firms count against quota — re-pages and overlapping queries are free.
/v1/get/:idbearer · 50 firms / month free
Full disclosure bundle: URL, phone, email, social, legal name, address, pricing range. id = the 12-char hex from/v1/search. 404s are not charged. BYO: any caller with their own apex list can compute the id locally assha256(apex.lower().rstrip('.')).hexdigest()[:12].
/v1/researchpaid · deferred
LLM-judged fit assessment with a shared cache on (firm_id, query_hash). Cache hits free across all users. Not in MVP.

Quick start

Anonymous, from any shell:

curl /v1/explore

curl 'https://api.servicegraph.co/v1/explore?filter=industry:management_consulting+state:CA'

Authed flow — get a 90-day bearer token via email + OTP:

curl /v1/auth/*

# 1. trigger an OTP email
curl -X POST 'https://api.servicegraph.co/v1/auth/request-otp' \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

# 2. verify the code that arrived in your inbox
curl -X POST 'https://api.servicegraph.co/v1/auth/verify-otp' \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","code":"123456","name":"my-cli"}'
# → { "token": "vk_…", "expires_at": "...", "user": {...} }

# 3. use the token
curl -H "Authorization: Bearer $TOKEN" \
  'https://api.servicegraph.co/v1/search?filter=industry:legal+state:CA&limit=5'

In this console

DSL — filter grammar, examples, live syntax checker, field catalog
Endpoints — every route with description sourced from /openapi.json
Playground — pick an endpoint, fill params, run, see raw and friendly responses, save queries
Account — sign in / out, see your plan and quota, manage tokens