SolutionsHow It WorksFor AgentsPricingBlogAffiliatesDocsContact
Log InSign Up

REST API

Find companies by what they do, over HTTP

One GET returns ranked companies from an index of 80M+ crawled business websites. Pass a natural language ICP, up to 10 seed domains, exact homepage phrases, tech stack, size, country, or language. Firmographics come back on every record, and contacts, enrichment, and CRM push are separate calls on the same key.

Working inside Claude, Cursor, or VS Code? The MCP server needs no key at all.

Quick start
pip install "discolike[cli]"
discolike auth login        # browser OAuth, or --api-key KEY

discolike discover --icp-prompt "B2B SaaS for logistics" --max-records 5
No account yet? Copy and tell this to your agent
Create a DiscoLike account for me. Follow https://docs.discolike.com/guides/agent-signup/, ask me for anything you need, and tell me what to do next.

How do I search for companies with the API?

Three ways to describe the target, one endpoint. The SDK validates parameters locally before the request goes out. Count is free, so an agent can size the result set before spending credits on records.

Search by natural language ICP

Describe the ideal customer in plain English. icp_prompt extracts filters and seed domains from the sentence, then ranks matches from 80M+ crawled business websites.

Python
from discolike import Discolike
from discolike.requests import DiscoverParams

client = Discolike()  # reads DISCOLIKE_API_KEY
companies = client.discover(
    DiscoverParams(
        icp_prompt="cybersecurity for SMBs, managed IT, endpoint protection",
        country=["US"],
        max_records=100,
    )
)
for c in companies:
    print(c.domain, c.name, c.similarity)
CLI
discolike discover \
  --icp-prompt "cybersecurity for SMBs, managed IT, endpoint protection" \
  --country US --max-records 100 --format json

Same call over HTTP: GET https://api.discolike.com/v1/discover?icp_prompt=cybersecurity+for+SMBs%2C+managed+IT%2C+endpoint+protection&country=US&max_records=100
Every parameter and response field: endpoint reference

Lookalikes from seed domains

Pass up to 10 customer domains. Results are ranked by similarity to what those companies actually do on the web, not by shared LinkedIn tags.

Python
companies = client.discover(
    DiscoverParams(
        domain=["stripe.com", "adyen.com"],
        employee_range="51,500",
        max_records=500,
    )
)
CLI
discolike discover \
  --domain stripe.com --domain adyen.com \
  --employee-range 51,500 --max-records 500 --format json

Same call over HTTP: GET https://api.discolike.com/v1/discover?domain=stripe.com&domain=adyen.com&employee_range=51%2C500&max_records=500
Every parameter and response field: endpoint reference

Exact phrase on the homepage

Match text fragments that appear on the company homepage. Count first so the agent knows the size of the set before spending credits.

Python
from discolike.requests import CountParams

count = client.count(
    CountParams(
        phrase_match=["managed detection and response"],
        country=["DE"],
    )
)
print(count.count)
CLI
discolike count \
  --phrase-match "managed detection and response" --country DE

Same call over HTTP: GET https://api.discolike.com/v1/count?phrase_match=managed+detection+and+response&country=DE
Every parameter and response field: endpoint reference

Contacts, enrichment, segmentation, DiscoGen, and CRM follow the same shape. Full method list by namespace: SDK reference. Every endpoint: docs.discolike.com

How does an agent sign up for the API?

One unauthenticated POST creates the account. The agent sends the person's work email and name plus its own name and relays the next_step text from the response. No credential is returned. The person confirms by email, logs in, picks a plan from $99 per month, and issues the API key under Settings, API Keys.

Free-mail and disposable domains are rejected. A 409 means the account already exists.

Agent guide: docs.discolike.com/guides/agent-signup →

Request
POST https://api.discolike.com/v1/public/signup
Content-Type: application/json

{
  "email": "jane@acme.com",
  "first_name": "Jane",
  "last_name": "Doe",
  "agent": "claude-code"
}

Frequently Asked Questions

What does the DiscoLike company search API do?
It returns ranked companies from an index of 80M+ crawled business websites. One GET /v1/discover call accepts a natural language ICP, lookalike seed domains, exact homepage phrases, tech stack, industry, employee range, revenue range, country, and language, and returns up to 10,000 records with firmographics per page.
How do I authenticate?
Send the key in an X-API-Key header, or an OAuth bearer token in Authorization. Keys are issued under Settings, API Keys after login. The Python SDK reads DISCOLIKE_API_KEY from the environment. The full OpenAPI 3.1 description is at https://api.discolike.com/v1/openapi.json and the auth summary for agents is at https://discolike.com/auth.md.
Is there a free API tier?
No. Every paid plan from $99 per month includes REST API access for internal use. Each search costs a query fee plus a fee per 1,000 new records. Companies retrieved in the last 90 days are cached and free, and GET /v1/count is free to call before a search.
Can an agent sign up without a browser?
Yes. POST https://api.discolike.com/v1/public/signup with a JSON body of email, first_name, last_name, and agent needs no auth header. Free-mail and disposable domains are rejected, and 409 means the account already exists. The person gets a confirmation email and issues the API key after login.
What are the rate limits?
Throughput scales with plan: Starter is the 1x baseline, Pro 2x, Team 3x, Company 5x, and Enterprise 20x. Bulk endpoints accept up to 10,000 rows per request. Ask for a higher ceiling through support if a pipeline needs it.
Where does the data come from?
DiscoLike crawls business websites directly and validates each domain against its SSL certificate, which keeps parked and dead domains out of results. Firmographics, vendor detection, and site text come from that crawl and refresh every 90 days. Contact records are added on top of the companies the crawl finds.
DiscoLike

Put a real search engine under your GTM

  • 80M+ companies in our own index
  • 1B company pages crawled
  • Self-serve from $99/mo, no demo required
  • Company data from public web sources
Sign Up