{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-v2/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Find Companies","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"find-companies","__idx":0},"children":["Find Companies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The HG API offers two ways to find companies: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Match"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search"]},". Use the one that fits your situation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"match-vs-search","__idx":1},"children":["Match vs Search"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Match"},"children":["Match"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Search"},"children":["Search"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You have company names, domains, or countries and need to find their HG records"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You want to discover companies based on criteria like industry, tech stack, or spend"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Input"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Up to 10 companies per request (name, domain, and/or country)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filters (firmographics, installs, spend, intent)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HG company records ranked by relevance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Paginated list of matching companies"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credits"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No (requires positive balance)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No (requires positive balance)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /companies/match"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /companies/search"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Common workflow"]},": Use Match to resolve your existing company list into HG IDs, then use Enrich to pull their data. Use Search to discover new companies you don't already know about — Search returns minimal data (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]},"), so follow up with Enrich to get firmographics, technographics, or spend."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"company-match","__idx":2},"children":["Company Match"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resolve companies from partial information. Submit a company name, domain, and/or country, and get back ranked HG company matches."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /data-api/v2/companies/match\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request","__idx":3},"children":["Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each company must include at least one of: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},". The more fields you provide, the better the match quality."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"companies\": [\n    {\n      \"name\": \"Ford Motor Company\",\n      \"domain\": \"ford.com\",\n      \"country\": \"US\"\n    },\n    {\n      \"domain\": \"google.com\"\n    },\n    {\n      \"name\": \"Walmart\",\n      \"country\": \"US\"\n    }\n  ],\n  \"limit\": 3\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parameters","__idx":4},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of companies to match (1-10)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies[].name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies[].domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company domain (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ford.com"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies[].country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Country name or ISO 3166 alpha-2 code (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum matches per company (1-10, default: 1)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["*At least one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," is required per company."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":5},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Results are returned in the same order as the input, with matches sorted by relevance."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"companies\": [\n    {\n      \"name\": \"Ford Motor Company\",\n      \"domain\": \"ford.com\",\n      \"country\": \"US\",\n      \"matches\": [\n        {\n          \"id\": \"E48EDEB162A5FBFDAF2DCF707079F8F\",\n          \"name\": \"Ford Motor Company\",\n          \"domain\": \"ford.com\",\n          \"country\": \"US\",\n          \"matched_on\": [\"name\", \"domain\", \"country\"]\n        }\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HG company ID — use this for enrichment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matched company name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matched company domain"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matched company country"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matched_on"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fields that contributed to the match (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"match-then-enrich","__idx":6},"children":["Match then Enrich"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A common workflow is to match first, then enrich the results:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"companies\": {\n    \"ids\": [\"E48EDEB162A5FBFDAF2DCF707079F8F\"]\n  },\n  \"fields\": [\"firmographics\", \"technographics\", \"spend\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"company-search","__idx":7},"children":["Company Search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Find companies across the entire HG database using filters. You can filter by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firmographics"]}," — country, employee count, revenue, industry, region, NAICS/SIC codes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Technology installs"]}," — vendors, products, product categories"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Spend"]}," — spend categories with min/max range"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Intent"]}," — topics and signal score (LOW / MEDIUM / HIGH)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Corporate hierarchy"]}," — global headquarters, domestic parent"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All filter categories use AND logic — combine as many as you need."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search returns minimal company data (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]},"). To get firmographics, technographics, or spend data for the results, pass the returned IDs to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/v2/guides/enrichment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /companies/enrich"]}]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /data-api/v2/companies/search\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-1","__idx":8},"children":["Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A search request requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}," (what to return) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]}," (what to search for)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"fields\": [\"id\", \"name\", \"domain\"],\n  \"filters\": {\n    \"firmographics\": {\n      \"country_codes\": [\n        {\"ids\": [\"US\"], \"inclusion_method\": \"ANY_PRESENT\"}\n      ],\n      \"employees\": {\"min\": 1000}\n    }\n  },\n  \"limit\": 10\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parameters-1","__idx":9},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fields to return: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain_normalized"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter criteria (see below)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Results per page (1-100, default: 10)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip results for pagination (default: 0)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sorts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sort by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direction"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ASC"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DESC"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"filters","__idx":10},"children":["Filters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Combine any of the following. All filter categories use AND logic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"firmographics","__idx":11},"children":["Firmographics"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"firmographics\": {\n      \"country_codes\": [\n        {\"ids\": [\"US\", \"GB\"], \"inclusion_method\": \"ANY_PRESENT\"}\n      ],\n      \"employees\": {\"min\": 1000, \"max\": 50000},\n      \"revenue\": {\"min\": 100000000},\n      \"industries\": [\n        {\"ids\": [16], \"inclusion_method\": \"ANY_PRESENT\"}\n      ]\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also filter by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["region_names"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["naics_codes"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sic_codes"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"technology-installs","__idx":12},"children":["Technology Installs"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"installs\": {\n      \"vendors\": [\n        {\"ids\": [316], \"inclusion_method\": \"ANY_PRESENT\"}\n      ],\n      \"products\": [\n        {\"ids\": [814], \"inclusion_method\": \"ANY_PRESENT\"}\n      ],\n      \"product_categories\": {\n        \"ids\": [\"63E88D6A88D45AB23B4CB4E71CB5A2E\"],\n        \"inclusion_method\": \"ANY_PRESENT\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two additional filters apply across whichever of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendors"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_categories"]}," you also specify in the same request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}]}," — restrict to installs located in a specific country, independent of the company's own headquarters. For example, a US-headquartered company with a product installed at its German office would match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country: {\"codes\": [\"DE\"]}"]},", even though the company itself is not based in Germany."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_last_verified_date"]}]}," — restrict to installs last verified within a date range (inclusive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["min"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max"]},", ISO 8601 dates)."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"installs\": {\n      \"vendors\": [\n        {\"ids\": [316], \"inclusion_method\": \"ANY_PRESENT\"}\n      ],\n      \"country\": {\"codes\": [\"DE\"]},\n      \"product_last_verified_date\": {\"min\": \"2026-01-01\", \"max\": \"2026-12-31\"}\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"spend","__idx":13},"children":["Spend"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"spend\": [\n      {\n        \"categories\": {\n          \"ids\": [\"3B36D42E7F8E60BE58BA4356B6AF40C\"],\n          \"inclusion_method\": \"ANY_PRESENT\"\n        },\n        \"range\": {\"min\": 1000000}\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"intent","__idx":14},"children":["Intent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Available for all topics regardless of your plan."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"intent\": {\n      \"topics\": {\n        \"ids\": [\"19861D3AC60455102792F87A33AF533F\"],\n        \"inclusion_method\": \"ANY_PRESENT\"\n      },\n      \"signal_score\": \"MEDIUM\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Signal score values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LOW"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MEDIUM"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HIGH"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"corporate-hierarchy","__idx":15},"children":["Corporate Hierarchy"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filters\": {\n    \"corporate_hierarchy\": {\n      \"is_global_headquarters\": true,\n      \"is_domestic_parent\": true\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"inclusion-methods","__idx":16},"children":["Inclusion Methods"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ANY_PRESENT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matches if ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["any"]}," of the specified IDs are present"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ALL_PRESENT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matches only if ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all"]}," specified IDs are present"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NONE_PRESENT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matches only if ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["none"]}," of the specified IDs are present"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-1","__idx":17},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"companies\": [\n    {\n      \"id\": \"1698C53EBC888758570396E0334965C1\",\n      \"name\": \"Walmart Inc.\",\n      \"domain\": \"walmart.com\"\n    }\n  ],\n  \"count\": 1,\n  \"total\": 4523\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pagination","__idx":18},"children":["Pagination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," to page through results. For the next page, increment ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["25,000 record limit:"]}," To protect performance for all users, each search query returns at most 25,000 records (100 per page × 250 pages). The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," in the response reflects the true match count — if it exceeds 25,000, add filters to retrieve targeted segments. Combine firmographic, install, and intent filters to stay under the limit. Company Search does not consume credits, but requires a positive balance — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/v2/guides/credits-and-usage"},"children":["Credits and Usage"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"fields\": [\"id\", \"name\", \"domain\"],\n  \"filters\": { ... },\n  \"limit\": 100,\n  \"offset\": 100\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"full-example","__idx":19},"children":["Full Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["US companies with 5,000+ employees that use Salesforce:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"fields\": [\"id\", \"name\", \"domain\"],\n  \"filters\": {\n    \"firmographics\": {\n      \"country_codes\": [\n        {\"ids\": [\"US\"], \"inclusion_method\": \"ANY_PRESENT\"}\n      ],\n      \"employees\": {\"min\": 5000}\n    },\n    \"installs\": {\n      \"vendors\": [\n        {\"ids\": [316], \"inclusion_method\": \"ANY_PRESENT\"}\n      ]\n    }\n  },\n  \"sorts\": [{\"field\": \"name\", \"direction\": \"ASC\"}],\n  \"limit\": 25\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tips","__idx":20},"children":["Tips"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catalog API"]}," to look up IDs for vendors, products, categories, industries, and intent topics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Neither ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Match"]}," nor ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search"]}," consumes credits, but both require a positive balance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide more fields to Match for better accuracy — name + country is more precise than name alone"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start Search with broad filters and narrow down — the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," field tells you how many companies match"]}]}]},"headings":[{"value":"Find Companies","id":"find-companies","depth":1},{"value":"Match vs Search","id":"match-vs-search","depth":2},{"value":"Company Match","id":"company-match","depth":2},{"value":"Request","id":"request","depth":3},{"value":"Parameters","id":"parameters","depth":3},{"value":"Response","id":"response","depth":3},{"value":"Match then Enrich","id":"match-then-enrich","depth":3},{"value":"Company Search","id":"company-search","depth":2},{"value":"Request","id":"request-1","depth":3},{"value":"Parameters","id":"parameters-1","depth":3},{"value":"Filters","id":"filters","depth":3},{"value":"Firmographics","id":"firmographics","depth":4},{"value":"Technology Installs","id":"technology-installs","depth":4},{"value":"Spend","id":"spend","depth":4},{"value":"Intent","id":"intent","depth":4},{"value":"Corporate Hierarchy","id":"corporate-hierarchy","depth":4},{"value":"Inclusion Methods","id":"inclusion-methods","depth":3},{"value":"Response","id":"response-1","depth":3},{"value":"Pagination","id":"pagination","depth":3},{"value":"Full Example","id":"full-example","depth":3},{"value":"Tips","id":"tips","depth":2}],"frontmatter":{"seo":{"title":"Find Companies"}},"lastModified":"2026-07-22T21:45:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/v2/guides/find-companies","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}