v3

latestOpenAPI 3.1.02026-08-045365213.8 KB

Discover similar businesses

Search firmographic data using domain matching, ICP text matching, or phrase matching. Returns business profiles ranked by relevance with optional AI enhancement.

get/discover

Query parameters

phrase_matchstring[] nullable

Exact text fragments to search for in site content. Up to 20 fragments allowed.

Exact text fragments to search for in site content. Up to 20 fragments allowed.

negate_phrase_matchstring[] nullable

Exact text fragments to exclude from results. Up to 20 fragments allowed.

Exact text fragments to exclude from results. Up to 20 fragments allowed.

subdomainstring[] nullable

Limit results to specified subdomains. Maximum 10 allowed.

Limit results to specified subdomains. Maximum 10 allowed.

negate_subdomainstring[] nullable

Exclude specified subdomains from results. Maximum 10 allowed.

Exclude specified subdomains from results. Maximum 10 allowed.

tech_stackstring[] nullable

Filter to companies using specified vendor domains (up to 20).

Filter to companies using specified vendor domains (up to 20).

negate_tech_stackstring[] nullable

Exclude companies using specified vendor domains (up to 20).

Exclude companies using specified vendor domains (up to 20).

categorystring[] nullable

Filter by industry category. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, ENGINEERING, ENTERTAINMENT, ENVIRONMENTAL_SERVICES, FASHION_TEXTILE_AND_APPAREL, FINANCIAL_SERVICES, FOOD_AND_BEVERAGE, GAMING_AND_ESPORTS, GOVERNMENT_SERVICES, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, IT_SERVICES, LEGAL, MANUFACTURING, MEDIA, MINING_AND_METALS, NONPROFIT_AND_PHILANTHROPY, OIL_AND_GAS, PHARMACEUTICALS, PRIVATE_EQUITY_AND_VENTURE_CAPITAL, REAL_ESTATE, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SAAS, SECURITY, SOFTWARE, SPORTS_AND_RECREATION, SUPPLY_CHAIN_AND_PROCUREMENT, TELECOMMUNICATIONS, TRAVEL, WELLNESS_AND_LIFESTYLE.

Filter by industry category. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, ENGINEERING, ENTERTAINMENT, ENVIRONMENTAL_SERVICES, FASHION_TEXTILE_AND_APPAREL, FINANCIAL_SERVICES, FOOD_AND_BEVERAGE, GAMING_AND_ESPORTS, GOVERNMENT_SERVICES, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, IT_SERVICES, LEGAL, MANUFACTURING, MEDIA, MINING_AND_METALS, NONPROFIT_AND_PHILANTHROPY, OIL_AND_GAS, PHARMACEUTICALS, PRIVATE_EQUITY_AND_VENTURE_CAPITAL, REAL_ESTATE, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SAAS, SECURITY, SOFTWARE, SPORTS_AND_RECREATION, SUPPLY_CHAIN_AND_PROCUREMENT, TELECOMMUNICATIONS, TRAVEL, WELLNESS_AND_LIFESTYLE.

negate_categorystring[] nullable

Exclude specified industry categories. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, ENGINEERING, ENTERTAINMENT, ENVIRONMENTAL_SERVICES, FASHION_TEXTILE_AND_APPAREL, FINANCIAL_SERVICES, FOOD_AND_BEVERAGE, GAMING_AND_ESPORTS, GOVERNMENT_SERVICES, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, IT_SERVICES, LEGAL, MANUFACTURING, MEDIA, MINING_AND_METALS, NONPROFIT_AND_PHILANTHROPY, OIL_AND_GAS, PHARMACEUTICALS, PRIVATE_EQUITY_AND_VENTURE_CAPITAL, REAL_ESTATE, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SAAS, SECURITY, SOFTWARE, SPORTS_AND_RECREATION, SUPPLY_CHAIN_AND_PROCUREMENT, TELECOMMUNICATIONS, TRAVEL, WELLNESS_AND_LIFESTYLE.

Exclude specified industry categories. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, ENGINEERING, ENTERTAINMENT, ENVIRONMENTAL_SERVICES, FASHION_TEXTILE_AND_APPAREL, FINANCIAL_SERVICES, FOOD_AND_BEVERAGE, GAMING_AND_ESPORTS, GOVERNMENT_SERVICES, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, IT_SERVICES, LEGAL, MANUFACTURING, MEDIA, MINING_AND_METALS, NONPROFIT_AND_PHILANTHROPY, OIL_AND_GAS, PHARMACEUTICALS, PRIVATE_EQUITY_AND_VENTURE_CAPITAL, REAL_ESTATE, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SAAS, SECURITY, SOFTWARE, SPORTS_AND_RECREATION, SUPPLY_CHAIN_AND_PROCUREMENT, TELECOMMUNICATIONS, TRAVEL, WELLNESS_AND_LIFESTYLE.

min_digital_footprintinteger

Minimum digital footprint score (0-800). Default 50.

Minimum digital footprint score (0-800). Default 50.

max_digital_footprintinteger

Maximum digital footprint score (0-800). Default 800.

Maximum digital footprint score (0-800). Default 800.

statestring[] nullable

Filter by state codes. Not supported with multiple countries.

Filter by state codes. Not supported with multiple countries.

negate_statestring[] nullable

Exclude specified states from results.

Exclude specified states from results.

countrystring[] nullable

Filter by ISO-3166-1 alpha-2 country codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ.

Filter by ISO-3166-1 alpha-2 country codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ.

negate_countrystring[] nullable

Exclude specified countries from results. Accepts same codes and region aliases as country.

Exclude specified countries from results. Accepts same codes and region aliases as country.

start_datestring nullable

Minimum company start date (YYYY-MM-DD) or range (YYYY-MM-DD,YYYY-MM-DD).

Minimum company start date (YYYY-MM-DD) or range (YYYY-MM-DD,YYYY-MM-DD).

redirectboolean

Include domains that redirect to another domain.

Include domains that redirect to another domain.

socialstring[] nullable

Filter by social platform presence. Valid values: facebook, instagram, linkedin, pinterest, threads, tiktok, twitter, x, yelp, youtube, googleplay, applestore, amazon, vk, bluesky, xing. Note: 'twitter' is an alias for 'x'.

Filter by social platform presence. Valid values: facebook, instagram, linkedin, pinterest, threads, tiktok, twitter, x, yelp, youtube, googleplay, applestore, amazon, vk, bluesky, xing. Note: 'twitter' is an alias for 'x'.

negate_socialstring[] nullable

Exclude companies with specified social profiles. Filter by social platform presence. Valid values: facebook, instagram, linkedin, pinterest, threads, tiktok, twitter, x, yelp, youtube, googleplay, applestore, amazon, vk, bluesky, xing. Note: 'twitter' is an alias for 'x'.

Exclude companies with specified social profiles. Filter by social platform presence. Valid values: facebook, instagram, linkedin, pinterest, threads, tiktok, twitter, x, yelp, youtube, googleplay, applestore, amazon, vk, bluesky, xing. Note: 'twitter' is an alias for 'x'.

languagestring[] nullable

Filter by site language. Valid values: ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), eo (Esperanto), es (Spanish), et (Estonian), eu (Basque), fa (Persian), fi (Finnish), fr (French), ga (Irish), gl (Galician), he (Hebrew), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), ky (Kyrgyz), lt (Lithuanian), lv (Latvian), ms (Malay), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sv (Swedish), sw (Swahili), th (Thai), tl (Tagalog), tr (Turkish), uk (Ukrainian), ur (Urdu), vi (Vietnamese), zh (Chinese (Simplified)), zt (Chinese (Traditional)).

Filter by site language. Valid values: ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), eo (Esperanto), es (Spanish), et (Estonian), eu (Basque), fa (Persian), fi (Finnish), fr (French), ga (Irish), gl (Galician), he (Hebrew), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), ky (Kyrgyz), lt (Lithuanian), lv (Latvian), ms (Malay), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sv (Swedish), sw (Swahili), th (Thai), tl (Tagalog), tr (Turkish), uk (Ukrainian), ur (Urdu), vi (Vietnamese), zh (Chinese (Simplified)), zt (Chinese (Traditional)).

negate_languagestring[] nullable

Exclude specified languages from results. Filter by site language. Valid values: ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), eo (Esperanto), es (Spanish), et (Estonian), eu (Basque), fa (Persian), fi (Finnish), fr (French), ga (Irish), gl (Galician), he (Hebrew), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), ky (Kyrgyz), lt (Lithuanian), lv (Latvian), ms (Malay), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sv (Swedish), sw (Swahili), th (Thai), tl (Tagalog), tr (Turkish), uk (Ukrainian), ur (Urdu), vi (Vietnamese), zh (Chinese (Simplified)), zt (Chinese (Traditional)).

Exclude specified languages from results. Filter by site language. Valid values: ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), eo (Esperanto), es (Spanish), et (Estonian), eu (Basque), fa (Persian), fi (Finnish), fr (French), ga (Irish), gl (Galician), he (Hebrew), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), ky (Kyrgyz), lt (Lithuanian), lv (Latvian), ms (Malay), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sv (Swedish), sw (Swahili), th (Thai), tl (Tagalog), tr (Turkish), uk (Ukrainian), ur (Urdu), vi (Vietnamese), zh (Chinese (Simplified)), zt (Chinese (Traditional)).

employee_rangestring nullable

Filter by employee count range. Format: 'min,max' (e.g., '1,5000'). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

Filter by employee count range. Format: 'min,max' (e.g., '1,5000'). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

revenue_rangestring nullable

Filter by company revenue. Format: 'min,max' in raw numbers (e.g., '1000000,10000000' for 1M-10M). Maps to buckets: <1M, 1-10M, 10-100M, 100M-1B, >1B. Unknown-revenue domains (N/A) are included when the range covers the <1M bucket.

Filter by company revenue. Format: 'min,max' in raw numbers (e.g., '1000000,10000000' for 1M-10M). Maps to buckets: <1M, 1-10M, 10-100M, 100M-1B, >1B. Unknown-revenue domains (N/A) are included when the range covers the <1M bucket.

business_modelstring[] nullable

Filter by business model label. Multi-select with OR semantics. Valid values: B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B.

Filter by business model label. Multi-select with OR semantics. Valid values: B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B.

negate_business_modelstring[] nullable

Exclude domains with these business model labels. Filter by business model label. Multi-select with OR semantics. Valid values: B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B.

Exclude domains with these business model labels. Filter by business model label. Multi-select with OR semantics. Valid values: B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B.

exclude_leadgenboolean

Exclude suspected lead generation sites. Filters out profiles with score <= 25 that also lack phone, email, and social media presence.

Exclude suspected lead generation sites. Filters out profiles with score <= 25 that also lack phone, email, and social media presence.

exact_matchstring[] nullable
negate_exact_matchstring[] nullable
vendorstring[] nullable
negate_vendorstring[] nullable
min_scoreinteger nullable
max_scoreinteger nullable
domainstring[] nullable

Domain(s) for lookalike matching. Up to 10 domains allowed.

Domain(s) for lookalike matching. Up to 10 domains allowed.

negate_domainstring[] nullable

Exclude results matching these domain contexts. Up to 10 domains.

Exclude results matching these domain contexts. Up to 10 domains.

exclude_domainstring[] nullable

Hard-exclude these exact domains from results without affecting lookalike matching. Accepts comma-separated or repeated params. Up to 100 domains. Requires PRO plan.

Hard-exclude these exact domains from results without affecting lookalike matching. Accepts comma-separated or repeated params. Up to 100 domains. Requires PRO plan.

icp_textstring nullable

Natural language description of ideal customer profile for semantic matching.

Natural language description of ideal customer profile for semantic matching.

negate_icp_textstring nullable

Description of business concepts to exclude from results.

Description of business concepts to exclude from results.

retrievalboolean

Enable page data retrieval using Extract API.

Enable page data retrieval using Extract API.

enhancedboolean

Enable AI-powered result enhancement for improved relevance.

Enable AI-powered result enhancement for improved relevance.

include_search_domainsboolean

Include input domains in results (excluded by default).

Include input domains in results (excluded by default).

max_recordsinteger

Maximum records to return (5-10000). Default 100.

Maximum records to return (5-10000). Default 100.

consensusinteger

Number of top results for consensus search vector (1-20). Higher values reduce specificity.

Number of top results for consensus search vector (1-20). Higher values reduce specificity.

min_similarityinteger

Minimum similarity score to include (0-99).

Minimum similarity score to include (0-99).

variance'LOW' | 'MID_LOW' | 'MEDIUM' | 'MID_HIGH' | 'HIGH' | 'UNRESTRICTED'

Result diversity control: LOW, MID_LOW, MEDIUM, MID_HIGH, HIGH, UNRESTRICTED.

Result diversity control: LOW, MID_LOW, MEDIUM, MID_HIGH, HIGH, UNRESTRICTED.

offsetinteger

Records to skip for pagination.

Records to skip for pagination.

exclusion_query_idstring[] nullable

Exclude domains from saved queries. Requires PRO plan.

Exclude domains from saved queries. Requires PRO plan.

inclusion_query_idstring[] nullable

Include domains from saved queries. Requires STARTER plan.

Include domains from saved queries. Requires STARTER plan.

auto_icp_textboolean

Auto-generate ICP text from provided domain(s).

Auto-generate ICP text from provided domain(s).

auto_phrase_matchboolean

Auto-generate phrase matches from ICP text.

Auto-generate phrase matches from ICP text.

icp_promptstring nullable

Natural language ICP description. Automatically extracts structured filters, generates ICP text, suggests domains, and applies them before running discovery. Overrides auto_icp_text and auto_phrase_match when set.

Natural language ICP description. Automatically extracts structured filters, generates ICP text, suggests domains, and applies them before running discovery. Overrides auto_icp_text and auto_phrase_match when set.

nl_matchstring nullable
negate_nl_matchstring nullable

Response

Successful Response

domainstring required

Company domain and unique record identifier

namestring nullable

Latest and most accurate company name from certificate or website

scoreinteger nullable

Company size and buying power computed from certificates history (1-800)

start_datestring nullable

Company start date, derived from the date of the first certificate (YYYY-MM-DD)

end_datestring nullable

Company end date if closed (YYYY-MM-DD), empty if still in business

phonesstring[] nullable

Array of phone numbers listed on the website

public_emailsstring[] nullable

Array of contact emails listed on the website

domain_associationsstring[]

Associated domains

social_urlsstring[] nullable

URLs pointing to the company page on Twitter, LinkedIn, Facebook

redirect_domainstring nullable

Last domain in the redirect chain, if any

descriptionstring nullable

Description, from website metatags or content

keywordsobject

Keywords generated by Natural Language Models based on site content, as keyword:confidence pairs

industry_groupsobject

Top industries (up to 2), as industry:confidence pairs

employeesstring nullable

Employee count bucket (output only). To filter, use employee_range with 'min,max' format (e.g., '51,200')

revenue_range'<1M' | '1-10M' | '10-100M' | '100M-1B' | '>1B' | 'N/A' nullable

Company revenue bucket: <1M, 1-10M, 10-100M, 100M-1B, >1B, or N/A when unknown

business_modelobject

Business model labels as label:confidence pairs (B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B)

update_datestring nullable

Date of last record update (YYYY-MM-DD)

mx_providerstring nullable

Email/MX hosting provider for the domain: a provider domain (e.g. 'google.com', 'microsoft.com'), the sentinel 'no_mx' when the domain was checked and has no mail server, or null when not resolved

{"stackTrail":"components:schemas:DiscoverResult:properties:linkup","oasType":"schema","type":"unknown","title":"Linkup","description":"Deprecated field, always None"}
similaritynumber nullable

Similarity score 0-100 between output domain and query domains or NL text

vendorsstring[] nullable

Technology vendors used by company (when tech_stack filter is used)