Developers

BirdSift developer portal

Everything you need to integrate BirdSift: machine-readable API docs, workspace API keys, a Claude MCP connector, and a free sandbox to test against live data.

Documentation & specs

REST API reference

Versioned `/v1` endpoints to list leads, run bounded searches, and draft outreach. Markdown mirror available for agents.

OpenAPI 3.1 spec

Machine-readable surface for codegen, function calling, and agent discovery at `/openapi.json`.

MCP connector

Search, inspect saved leads, and draft outreach from Claude Desktop or Claude Code — OAuth, no API key in the client.

OAuth metadata

Authorization server and protected-resource metadata for MCP and OAuth clients.

API keys

BirdSift API keys are workspace-scoped secrets for server-side scripts and automations. Create one from the app: click the key icon in the header, name the key, and copy the plaintext — it is shown once and cannot be recovered. Keys use the `Authorization: Bearer bsk_live_…` header on `https://api.birdsift.com/v1/*`. Never embed a key in browser JavaScript or a public repo.

Create an API key

Quickstart

Every workspace starts with 25 free credits — enough to run a real search and draft outreach before you buy a pack. Replace `$BIRDSIFT_API_KEY` with a key you created in the app.

1. Read the public API docs (no auth)

curl -s https://api.birdsift.com/v1/docs

2. Check your credit balance

curl -s https://api.birdsift.com/v1/credits \
  -H "Authorization: Bearer $BIRDSIFT_API_KEY"

3. Run a bounded search

curl -s -X POST https://api.birdsift.com/v1/searches \
  -H "Authorization: Bearer $BIRDSIFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries":[{"location":"Austin, TX","category":"dentist"}],"filters":{"no_website":true},"max_results":5}'

Sandbox environment

BirdSift does not operate a separate mock API — the sandbox is your own workspace on production infrastructure with 25 free credits at signup. Run real Google Places searches, save leads, and draft outreach against live data without entering a card. When credits run out, buy a pack from Pricing or pause until you are ready.

Start in the sandbox

Build on BirdSift

Open the app