Discover similar businesses

Changed on

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

get/discover

Request

  • Base URL
    https://api.discolike.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Query parameters

phrase_matchstring[] nullable

Exact text fragments to search for in site content. Up to 20 fragments, each at least 3 characters. Any one plain fragment matches; prefix + to require one, and +a|b requires any one of a, b.

negate_phrase_matchstring[] nullable

Exact text fragments to exclude from results. Up to 20 fragments, each at least 3 characters.

subdomainstring[] nullable

Limit results to specified subdomains. Up to 20, each at least 3 characters.

negate_subdomainstring[] nullable

Exclude specified subdomains from results. Up to 20, each at least 3 characters.

tech_stackstring[] nullable

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

negate_tech_stackstring[] nullable

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

categorystring[] nullable

Filter by industry category (ANY-OF; prefix + to require a 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.

sub_industrystring[] nullable

Filter by sub-industry, a second-level label scoped to an industry category. Accepts a bare label (ROOFING) or a parent-qualified key (CONSTRUCTION/ROOFING), case-insensitive, up to 50 values, normalized to the qualified key. A bare label adds its parent to the category filter. A category with one of its sub-industries selected is narrowed to them; any other selected category stays whole, so category=SAAS,CONSTRUCTION with sub_industry=HOME_BUILDER returns SaaS companies and home builders.

negate_sub_industrystring[] nullable

Exclude specified sub-industries. Same format as sub_industry; does not affect the category filter.

latnumber nullable

Latitude of the search centre. Must be supplied together with lon.

lonnumber nullable

Longitude of the search centre. Must be supplied together with lat.

radiusstring nullable

Search radius around lat/lon: a number optionally suffixed with km or mi (50km, 30mi, 50). A bare number is kilometres. Defaults to 50km when lat/lon are supplied, maximum 1000km.

geostring[] nullable

A circular area to search, written lat,lon or lat,lon,radius (30.27,-97.74 or 30.27,-97.74,30mi). The radius is a number optionally suffixed with km or mi, a bare number meaning kilometres; it defaults to 50km and may not exceed 1000km. Repeatable: every geo circle, every bbox and the lat/lon/radius centre are OR'd together, up to 10 shapes in total.

bboxstring[] nullable

Bounding box as min_lat,min_lon,max_lat,max_lon. Longitudes may wrap the antimeridian (min_lon above max_lon). Repeatable: every geo circle, every bbox and the lat/lon/radius centre are OR'd together, up to 10 shapes in total.

min_digital_footprintinteger nullable

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

max_digital_footprintinteger nullable

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

statestring[] nullable

Filter by ISO 3166-2 state codes or names (up to 100), listed at https://docs.discolike.com/states/. Requires exactly one country value, which may be a region alias; the state is then resolved against every country the alias covers. A value that resolves under none is rejected.

negate_statestring[] nullable

Exclude specified states from results (up to 100). Same format and country rules as state.

countrystring[] nullable

ISO-3166-1 alpha-2 country codes (e.g., US, GB, DE) or region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ, EUROPE, ASIA, AFRICA, NORTH_AMERICA, SOUTH_AMERICA, OCEANIA, ANTARCTICA.

negate_countrystring[] nullable

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).

redirectboolean

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'.

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'.

languagestring[] nullable

Filter by site language. Valid values: af (Afrikaans), ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), bs (Bosnian), 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), hr (Croatian), hu (Hungarian), hy (Armenian), id (Indonesian), is (Icelandic), it (Italian), ja (Japanese), ka (Georgian), ko (Korean), ky (Kyrgyz), lb (Luxembourgish), lt (Lithuanian), lv (Latvian), mk (Macedonian), ms (Malay), my (Burmese), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sr (Serbian), 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: af (Afrikaans), ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), bs (Bosnian), 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), hr (Croatian), hu (Hungarian), hy (Armenian), id (Indonesian), is (Icelandic), it (Italian), ja (Japanese), ka (Georgian), ko (Korean), ky (Kyrgyz), lb (Luxembourgish), lt (Lithuanian), lv (Latvian), mk (Macedonian), ms (Malay), my (Burmese), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sr (Serbian), 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+.

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.

business_modelstring[] nullable

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.

valid_mxboolean

Only companies with a mail server.

exclude_leadgenboolean

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.

negate_domainstring[] nullable

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.

icp_textstring nullable

Natural language description of ideal customer profile for semantic matching (3-4000 characters).

negate_icp_textstring nullable

Description of business concepts to exclude from results (3-4000 characters).

retrievalboolean

Enable page data retrieval using Extract API.

enhancedboolean

Deprecated and ignored.

include_search_domainsboolean

Include input domains in results (excluded by default).

max_recordsinteger

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

consensusinteger

Deprecated and ignored.

min_similarityinteger

Minimum similarity score to include (0-99).

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

Deprecated. Use relevance; LOW/MID_LOW/MEDIUM map to MAX_RELEVANCE, MID_HIGH/HIGH to BALANCED, UNRESTRICTED to no stop.

relevance'MAX_RELEVANCE' | 'BALANCED' | 'MAX_COVERAGE' nullable

How far down the ranked list results go before the estimated ICP fit drops too low. Applies to lookalike searches (icp_text or domain). MAX_RELEVANCE stops earliest with the tightest fit, BALANCED goes further, MAX_COVERAGE serves the longest list. Omit for no automatic stop.

offsetinteger

Records to skip for pagination.

exclusion_query_idstring[] nullable

Exclude domains from saved queries.

inclusion_query_idstring[] nullable

Include domains from saved queries. Requires STARTER plan.

auto_icp_textboolean

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

auto_phrase_matchboolean

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.

nl_matchstring nullable
negate_nl_matchstring nullable

Response

Successful Response

domainstring required

Company domain and unique record identifier

namestring nullable

Company name inferred from certificate or website data

scoreinteger nullable

Digital footprint score derived from certificate history (1-800); not a verified measure of company size or buying power

start_datestring nullable

First observed certificate date (YYYY-MM-DD); not a verified company founding or incorporation date

end_datestring nullable

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

latitudenumber nullable

Latitude of the company's location, when resolved

longitudenumber nullable

Longitude of the company's location, when resolved

geo_precisionstring nullable

How precisely the location was resolved (e.g. rooftop, city, country)

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

sub_industryobject nullable

Sub-industry labels scoped to the company's industry category, as PARENT/SUB:confidence pairs; null when the domain was not scored against them

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 publishes a null MX record, or null when no MX record was found

linkupunknown
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)

Changes

    • breaking

      for the query request parameter max_records, default value was changed from 100 to 500

    • breaking

      removed the enum value ACCOUNTING from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value ADVERTISING_AND_MARKETING from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value AGRICULTURE_AND_NATURAL_RESOURCES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value ALCOHOL_AND_TOBACCO from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value AUTOMOTIVE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value BIG_DATA_AND_ANALYTICS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value BIOTECHNOLOGY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value BLOCKCHAIN_AND_CRYPTOCURRENCY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value BUSINESS_PRODUCTS_AND_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value CLOUD_COMPUTING from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value COMPUTER_HARDWARE_AND_SEMICONDUCTORS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value CONSTRUCTION from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value CONSUMER_PRODUCTS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value CONSUMER_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value CYBERSECURITY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value DEFENSE_AND_AEROSPACE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value E-COMMERCE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value EDUCATION from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value ENERGY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value ENGINEERING from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value ENTERTAINMENT from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value ENVIRONMENTAL_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value FASHION_TEXTILE_AND_APPAREL from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value FINANCIAL_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value FOOD_AND_BEVERAGE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value GAMING_AND_ESPORTS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value GOVERNMENT_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value HEALTHCARE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value HOSPITALITY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value HUMAN_RESOURCES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value INSURANCE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value IT_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value LEGAL from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value MANUFACTURING from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value MEDIA from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value MINING_AND_METALS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value NONPROFIT_AND_PHILANTHROPY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value OIL_AND_GAS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value PHARMACEUTICALS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value PRIVATE_EQUITY_AND_VENTURE_CAPITAL from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value REAL_ESTATE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value RENEWABLE_ENERGY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value RESTAURANTS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value RETAIL from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value SAAS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value SECURITY from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value SOFTWARE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value SPORTS_AND_RECREATION from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value SUPPLY_CHAIN_AND_PROCUREMENT from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value TELECOMMUNICATIONS from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value TRAVEL from the property anyOf[subschema #1]/items/ of the query request parameter category

    • breaking

      removed the enum value WELLNESS_AND_LIFESTYLE from the property anyOf[subschema #1]/items/ of the query request parameter category

    • info

      added the new optional query request parameter valid_mx

    • info

      added the enum value af to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value af to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value hy to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value hy to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value is to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value is to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value ka to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value ka to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value lb to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value lb to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the new optional query request parameter relevance

    • info

      query request parameter consensus was deprecated

    • info

      query request parameter enhanced was deprecated

    • info

      query request parameter variance was deprecated