● DEVELOPER DOCS

Build on 13.3M companies

Programmatic access to the WebScans corpus — 178 fields per domain, FAISS-powered lookalike search, real-time enrichment cascade, and an AI Copilot that speaks natural language. Pick your interface below.

⚡

REST API HTTP

Every endpoint documented with curl / Python / TypeScript examples. Auth via Bearer token. OpenAPI 3.1 spec at /openapi.json.

# Full profile in one call curl https://webscans.com/enrich/stripe.com \
-H "Authorization: Bearer ws_..."

🐍

Python SDK pip

Typed sync + async clients over the full API. Pydantic response models. Zero config for public endpoints.

# pip install webscans from webscans import WebScans
ws = WebScans(api_key="ws_...")
p = ws.enrich("stripe.com")

⌘

CLI shell

Every SDK tool as a shell command with pretty output + --json for scripting. Ships in the same pip install webscans.

$ webscans enrich stripe.com
$ webscans search "solar panels" --tech HubSpot -n 25
$ webscans similar figma.com -k 10

🧬

MCP Server agents

Model Context Protocol server so Claude Desktop, Claude Code, Cursor, and any agent framework can call every tool.

# pip install "webscans[mcp]" $ webscans mcp
# Register in Claude Desktop's config

What can you do with it?

WebScans indexes 13,288,086 company homepages, each enriched with up to 178 fields: industry, tech stack, country, ISO codes, emails, phones, traffic rank, embeddings, and more. Every field is queryable and exportable.

The 12 canonical tools

Same 12 tools across REST, SDK, CLI, and MCP — perfect parity so your code translates 1:1 between environments.

Tool	Purpose	REST endpoint
`search`	Keyword + phrase + filter search across 13.3M homepages	`GET /search`
`count`	Cheap total-match count for a query	`GET /search/count`
`export_search`	Full-CSV export of search results (up to 1M rows)	`GET /search/download`
`bulk_search`	Deduplicated CSV across many keywords	`GET /bulk-search/download`
`domain`	Cached 178-field profile for a domain	`GET /domain/{d}`
`similar`	Lookalike / competitor discovery via FAISS embeddings	`GET /domain/{d}/competitors`
`lookup`	Cache + live-crawl fallback	`GET /lookup/{d}`
`enrich`	Real-time cascade (cache → race → Playwright → BrightData)	`GET /enrich/{d}`
`bulk_lookup`	Batch enrichment (upload CSV, get enriched CSV)	`POST /bulk-lookup`
`autocomplete`	As-you-type suggestions	`GET /autocomplete`
`copilot`	Natural-language search — Claude picks the right tool	`POST /copilot/query`
`my_companies`	Export your saved-company list as CSV	`GET /my-companies/export`

Ready to build?

Grab an API key and you're 30 seconds from your first call.

Get an API key → GitHub API Reference