Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/birdsift-com:birdsift-com-searches-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: BirdSift Searches API
version: 1.0.0
description: 'BirdSift API v1 — list saved leads, run bounded local-business searches, and draft outreach. Human-readable reference: https://www.birdsift.com/docs/api. Agent instructions: https://www.birdsift.com/agent-instructions. Rate limit: 60 requests/minute per API key. Searches and outreach drafts consume workspace credits.'
contact:
name: BirdSift
url: https://www.birdsift.com/developers
servers:
- url: https://api.birdsift.com
security:
- ApiKeyAuth: []
tags:
- name: searches
description: Bounded lead discovery
paths:
/v1/searches:
post:
tags:
- searches
summary: Run a bounded search and save results
description: Queries Google Places for local businesses matching trade + location filters, verifies websites, saves matches as workspace leads, and debits credits.
operationId: createSearch
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
responses:
'200':
description: Search results saved as leads
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'400':
description: invalid_request — malformed body, queries or max_results out of range, or more than 2 queries from a workspace that has never bought credits
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'402':
description: Insufficient credits
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Rate limited (60 requests/minute per key)
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
SearchResultLead:
allOf:
- $ref: '#/components/schemas/LeadSummary'
- type: object
properties:
has_website:
type: boolean
nullable: true
is_mobile_friendly:
type: boolean
nullable: true
is_outdated:
type: boolean
nullable: true
SearchQuery:
type: object
required:
- location
- category
properties:
location:
type: string
description: City or region, e.g. Austin, TX
category:
type: string
description: Trade or business type, e.g. dentist
SearchResponse:
type: object
required:
- results
- credits_spent
- truncated
properties:
results:
type: array
items:
$ref: '#/components/schemas/SearchResultLead'
credits_spent:
type: integer
description: Credits consumed by this search
truncated:
type: boolean
description: True when max_results or the per-query cap (60) stopped the scan early, or analysis budget ran out
SearchRequest:
type: object
required:
- queries
- max_results
properties:
queries:
type: array
minItems: 1
maxItems: 5
description: Up to 5 queries. A workspace that has never bought credits can send at most 2 (400 invalid_request otherwise).
items:
$ref: '#/components/schemas/SearchQuery'
filters:
$ref: '#/components/schemas/SearchFilters'
max_results:
type: integer
minimum: 1
maximum: 25
description: Maximum leads to return across all queries
SearchFilters:
type: object
properties:
min_rating:
type: number
description: Minimum Google rating (0–5)
no_website:
type: boolean
description: Only businesses with no website
not_mobile_friendly:
type: boolean
description: Only non-mobile-friendly sites
outdated_website:
type: boolean
description: Only outdated-looking sites
stale_content:
type: boolean
description: Only sites whose newest homepage photo is 3+ years old. Narrow — the date is only readable on sites that file media by date.
LeadSummary:
type: object
required:
- id
- place_id
- name
- category
- address
- website
- email
- outreach_status
- added_at
properties:
id:
type: string
format: uuid
description: BirdSift lead UUID
place_id:
type: string
description: Google Places ID
name:
type: string
category:
type: string
description: Business category or trade
address:
type: string
nullable: true
website:
type: string
nullable: true
email:
type: string
nullable: true
outreach_status:
type: string
enum:
- new
- contacted
- replied
- won
- lost
description: Where the lead sits in the outreach pipeline
added_at:
type: string
format: date-time
ErrorResponse:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
securitySchemes:
ApiKeyAuth:
type: http
scheme: bearer
description: Workspace API key (`bsk_live_…`). Create from the app.
OAuth2:
type: oauth2
description: 'Supabase OAuth 2.0 access token for workspace-scoped MCP access. Metadata: GET /.well-known/oauth-authorization-server'
flows:
authorizationCode:
authorizationUrl: https://tzngbfxhkxvbtoxsypii.supabase.co/auth/v1/oauth/authorize
tokenUrl: https://tzngbfxhkxvbtoxsypii.supabase.co/auth/v1/oauth/token
scopes:
email: Email address
profile: Basic profile
externalDocs:
description: BirdSift API reference
url: https://www.birdsift.com/docs/api