Skip to content
Developers
API reference

Company search

Find companies by name.

POST/api/v1/entity/search
Scope
search
Formats
JSON · SSE
Sandbox
Free fixtures
curl https://deepsearch.app/api/v1/entity/search \  -H "Authorization: Bearer $DEEPSEARCH_API_KEY" \  -H "Content-Type: application/json" \  -d '{        "query": "Stripe"      }'
Example request

Authorization

Authorizationheaderrequired

Send Bearer $DEEPSEARCH_API_KEY with the search scope. The free sandbox uses the published test key.

Authentication guide

Body parameters

querystringrequired

The company name to look up.

formatenum

json collects the result; sse streams progress and result events.

jsonsse

Default: json

sandboxboolean

Return deterministic, unmetered fixtures.

Default: false

Response

JSON responses preserve the operation result and include request metadata, usage, and collected events. SSE delivers progress and result events as they arrive.

Streaming & formats 
{  "object": "entity_search_result",  "request_id": "req_01HZY8R3ENTITYSRCH9F4X9J7Z1",  "companies": [    {      "kind": "company",      "id": "stripe-us-de",      "name": "Stripe",      "legalName": "Stripe, Inc.",      "headline": "Payments · San Francisco · ~8000 employees",      "initials": "ST",      "confidence": 92,      "jurisdiction": "us_de",      "status": "active",      "tags": [        "Payments",        "Private"      ]    }  ],  "metadata": {    "api_version": "v1",    "operation": "entity_search",    "request_id": "req_01HZY8R3ENTITYSRCH9F4X9J7Z1",    "generated_at": "2026-10-01T12:00:00.000Z"  },  "usage": {    "metered": true,    "credits": 1,    "cached": false  },  "events": []}
Example responseapplication/json

Sources & coverage

Submit a company name and get ranked candidate companies (legal name, jurisdiction, status). Grounded in official registries and the public web. Pass a candidate to /entity/dossier for a full profile. Company lookup is Medium usage.

Usage & caching

Company lookup is Medium usage; idempotent replays use no usage.

Usage & rate limits

Examples illustrate the contract. Test request runs the selected deployment; sandbox fixtures are unmetered.