Discover API

Find companies matching your criteria using domain lookalike matching, natural language ICP descriptions, phrase matching, or structured filters. Returns BizData profiles ranked by relevance.

Use Count to preview result volume before running a full query, and Segment to group results into ICP clusters.

GET https://api.discolike.com/v1/discover

Discovery Methods

The discover endpoint supports multiple ways to find companies. You can combine them for hybrid search.

Method	Parameter	Description
ICP Prompt	`icp_prompt`	Describe your ICP in natural language; automatically extracts filters, generates ICP text, suggests domains
Domain Lookalike	`domain`	Provide example domains to find similar companies
ICP Text	`icp_text`	Describe your ideal customer in natural language
Filters Only	(structured filters)	Use location, industry, score, and other filters without a search vector

Parameters

Discovery Input

Parameter	Type	Description
domain	string[]	Domain(s) for lookalike matching (up to 10)
negate_domain	string[]	Domains to push results away from (up to 10)
icp_text	string	Natural language description of your ideal customer profile (3-4000 characters)
negate_icp_text	string	Description of business concepts to exclude (3-4000 characters)

Phrase Matching

Parameter	Type	Description
phrase_match	string[]	Exact text fragments to match in site content (up to 20, each at least 3 characters)
negate_phrase_match	string[]	Exact text fragments to exclude (up to 20, each at least 3 characters)

Location Filters

Parameter	Type	Description
country	string[]	ISO-3166-1 alpha-2 country codes (e.g., US, GB, DE). Also accepts region codes that auto-expand to member countries: `ANZ`, `APAC`, `ASEAN`, `BENELUX`, `CEE`, `DACH`, `EMEA`, `EU`, `GCC`, `LATAM`, `MENA`, `NORDICS`.
negate_country	string[]	Countries to exclude
state	string[]	State/province filter. Accepts ISO 3166-2 codes (e.g. `CA`, `BY`) or full names (e.g. `California`, `Bayern`). Scoped to a single country per request: if multiple `country` values are passed, `state` is rejected. Supported for 120+ countries; see States. Up to 100 values, each must resolve to a known subdivision.
negate_state	string[]	States to exclude (same format as `state`, up to 100)

Company Filters

Parameter	Type	Description
min_digital_footprint	integer	Minimum digital footprint score (0-800, default: 50). Must not exceed `max_digital_footprint`. When `start_date` is set, the floor is capped at the highest score a company of that age can reach (see Score methodology)
max_digital_footprint	integer	Maximum digital footprint score (0-800, default: 800)
start_date	string	Company start date: `YYYY-MM-DD` or range `YYYY-MM-DD,YYYY-MM-DD`
category	string[]	Industry filter (e.g. SOFTWARE, HEALTHCARE). See Industries for all 53 values.
negate_category	string[]	Industries to exclude
employee_range	string	Employee count range as `min,max` (e.g., `1,5000`). Open-ended forms: `50,` means “50 and above”, `,50` means “50 and below”. Buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
revenue_range	string	Company revenue range as `min,max` in raw integers (e.g., `1000000,10000000` for $1M-$10M). Use `+` suffix on max for unbounded (`1000000000+` for $1B+). Buckets: `<1M`, `1-10M`, `10-100M`, `100M-1B`, `>1B`. Domains with unknown revenue (`N/A`) are included when the range covers the `<1M` bucket.
business_model	string[]	Business-model labels (OR semantics). Values: `B2B`, `B2C`, `B2G`, `G2B`, `G2C`, `D2C`, `C2C`, `C2B`
negate_business_model	string[]	Business-model labels to exclude

Parameter	Type	Description
social	string[]	Require social presence: facebook, instagram, linkedin, twitter, x, youtube, tiktok, pinterest, threads, yelp, googleplay, applestore, amazon, vk, bluesky, xing
negate_social	string[]	Exclude companies with specified social profiles
language	string[]	Filter by site language (2-letter codes: en, de, fr, ja, etc.). See Languages for the full list.
negate_language	string[]	Languages to exclude
redirect	boolean	Include domains that redirect to another domain (default: false)
exclude_leadgen	boolean	Exclude suspected lead generation sites; filters out low-score profiles that also lack phone, email, and social media presence (default: true)

Tech Stack Targeting

Parameter	Type	Description
tech_stack	string[]	Filter to companies using specified vendor domains (up to 20)
negate_tech_stack	string[]	Exclude companies using specified vendor domains (up to 20)

Subdomain Targeting

Parameter	Type	Description
subdomain	string[]	Limit results to specified subdomains (up to 20)
negate_subdomain	string[]	Exclude specified subdomains (up to 20)

Query Inclusion

Parameter	Type	Description
inclusion_query_id	string[]	Limit to domains from saved query results

Query Exclusion

Parameter	Type	Description
exclusion_query_id	string[]	Exclude domains from saved query results
exclude_domain	string[]	Hard-exclude specific domains from results (up to 100). Accepts comma-separated (`a.com,b.com`) or repeated params. Unlike `negate_domain`, does not affect lookalike matching.

Result Controls

Parameter	Type	Default	Description
max_records	integer	100	Maximum records to return (5-10,000)
offset	integer	0	Records to skip for pagination
min_similarity	integer	0	Minimum similarity score (0-99)
consensus	integer	1	Number of top results for consensus search vector (1-20). Higher values reduce specificity
variance	string	UNRESTRICTED	Result diversity control: LOW, MID_LOW, MEDIUM, MID_HIGH, HIGH, UNRESTRICTED
include_search_domains	boolean	false	Include input domains in results

AI Features

Parameter	Type	Default	Description
enhanced	boolean	false	Enable AI-powered result enhancement for improved relevance
retrieval	boolean	false	Enable page data retrieval using Extract API
auto_icp_text	boolean	false	Auto-generate ICP text from provided domain(s)
auto_phrase_match	boolean	false	Auto-generate phrase matches from ICP text
icp_prompt	string		Natural language ICP description. Auto-extracts filters, generates cleaned ICP text, suggests lookalike domains, and runs discovery in one call. Overrides auto_icp_text and auto_phrase_match. Max 4000 characters

Validation

Limits enforced on every request. Count applies the same limits to the parameters it shares.

Rule	Parameters
3-4000 characters. An empty string is treated as if the parameter were omitted	`icp_text`, `negate_icp_text`
Max 4000 characters	`icp_prompt`
Max 10 items	`domain`, `negate_domain`
Max 20 items, each at least 3 characters	`phrase_match`, `negate_phrase_match`, `subdomain`, `negate_subdomain`
Max 20 items	`tech_stack`, `negate_tech_stack`
Max 100 items	`exclude_domain`
Max 100 items, each must resolve to an ISO 3166-2 subdivision code or name, and only with a single `country`	`state`, `negate_state`
`min_digital_footprint` must not exceed `max_digital_footprint`	`min_digital_footprint`, `max_digital_footprint`
`YYYY-MM-DD`, or `min,max` in the same format	`start_date`
5-10,000	`max_records`
1-20	`consensus`
0-99	`min_similarity`
0 or greater	`offset`
One of the listed values	`variance`
Unknown parameters are rejected	all

employee_range and revenue_range are the exception: a value that does not parse is silently dropped and the query runs without the filter.

Response Headers

Header	Description
X-Total-Count	Number of results returned
X-Applied-Filters	JSON object containing the filters actually used for the search. When `icp_prompt` is provided, this shows the extracted and merged filters (category, country, employee_range, tech_stack, phrase_match, icp_text, domain, etc.). Useful for understanding what the system interpreted from your prompt and for building iterative refinement workflows

Response Fields

Returns an array of BizData profiles with additional discovery fields:

Field	Type	Description
similarity	float	Similarity score (0-100) between result and query
vendors	string[]	Technology vendors detected (when tech_stack filter is used)
employees	string	Employee count range bucket

See the BizData dataset for the full profile schema.

Examples

Domain Lookalike

curl "https://api.discolike.com/v1/discover?domain=stripe.com&country=US&min_digital_footprint=100&max_records=50" \
  -H "x-discolike-key: API_KEY"

ICP Text Search

curl "https://api.discolike.com/v1/discover?icp_text=enterprise+SaaS+companies+in+financial+services&country=US&min_digital_footprint=200" \
  -H "x-discolike-key: API_KEY"

ICP Prompt (One-Call Discovery)

curl "https://api.discolike.com/v1/discover?icp_prompt=SaaS+companies+in+financial+services+with+50-200+employees+in+the+US&min_digital_footprint=200" \
  -H "x-discolike-key: API_KEY"

Phrase Match with Filters

curl "https://api.discolike.com/v1/discover?phrase_match=cloud+security&category=CYBERSECURITY&employee_range=51,5000" \
  -H "x-discolike-key: API_KEY"

Response

[
  {
    "domain": "acmesoftware.com",
    "name": "Acme Software",
    "similarity": 87.3,
    "status": { "status": "active", "confidence": 1 },
    "score": 450,
    "start_date": "2015-03-20",
    "address": {
      "city": "San Francisco",
      "state": "CA",
      "country": "US"
    },
    "phones": ["+15555550200"],
    "public_emails": ["info@acmesoftware.com"],
    "social_urls": ["https://linkedin.com/company/acme-software"],
    "redirect_domain": null,
    "description": "Enterprise software solutions for modern businesses.",
    "keywords": {
      "enterprise software": 0.72,
      "cloud platform": 0.65
    },
    "industry_groups": {
      "SOFTWARE": 0.89
    },
    "employees": "201-500",
    "mx_provider": "google.com"
  }
]