Enrich companies in bulk
Look up to 100 companies in one call, by domain or id (you can mix them). Accepts the same options as
GET /companies/{company}: show_icp, show_pricing, show_description and show_pages.
Results come back in the order you sent them; duplicates are returned once.
Costs 1 lookup per company found that isn't already paid for this billing month. Companies we can't find are
listed in not_found and aren't charged. If your allowance runs out partway, the companies it covered are returned
and usage.allowance_reached is true.
bearerAuthAuthorizationBearer <token>Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.
application/json- body
companies*array<string>Domains or CompanySpec ids.
1 <= items <= 100show_icp?booleanfalseshow_pricing?booleanfalseshow_description?booleanfalseshow_pages?booleanfalseCompanies found and not found.
application/json- response
companies*array<>not_found*array<string>usage*What this request cost and what is left this billing month.
curl -X POST 'https://api.companyspec.com/v1/companies/enrich' \ -H 'Content-Type: application/json' \ -d '{ "companies": [ "acmedental.io", "bracehub.com", "not-a-real-company.example" ], "show_icp": true}'{ "companies": [ { "id": "cmp_19ad3", "domain": "acmedental.io", "name": "AcmeDental", "website": "https://acmedental.io", "description": "Practice management software for independent dental clinics.", "logo_url": null, "type": "private", "founded_year": 2017, "ipo_date": null, "industry": "Software Development", "industries": [ "Software Development", "Healthcare Technology" ], "naics_codes": [ "513210" ], "sic_codes": [ "7372" ], "keywords": [ "practice management", "dental scheduling", "patient billing" ], "customer_types": [ "B2B" ], "customer_segments": [ "smb" ], "compliance": [ "HIPAA", "SOC 2" ], "technologies": [ "stripe", "twilio", "aws", "hubspot" ], "vendors": [ "aws", "stripe", "twilio" ], "employees": "51-200", "employee_count": 142, "revenue": "10m-50m", "location": { "country_code": "US", "country": "United States", "state": "Texas", "city": "Austin" }, "office_locations": [ { "country_code": "US", "country": "United States", "state": "Texas", "city": "Austin", "employee_count": 120 } ], "parent": null, "subsidiaries": [], "socials": { "linkedin_url": "https://www.linkedin.com/company/acmedental", "twitter_url": null, "facebook_url": null, "youtube_url": null, "github_url": null }, "open_jobs": 6, "web": { "traffic_rank": 184021 }, "icp": "AcmeDental provides cloud practice management software covering scheduling, charting and billing. They solve the pain of juggling separate tools for appointments and insurance claims. Their customers are likely independent dental practices and small multi-location groups in the US." }, { "id": "cmp_4kq7p", "domain": "bracehub.com", "name": "BraceHub", "website": "https://bracehub.com", "description": "Scheduling and patient communication software for orthodontic and dental practices.", "logo_url": null, "type": "private", "founded_year": 2019, "ipo_date": null, "industry": "Software Development", "industries": [ "Software Development", "Healthcare Technology" ], "naics_codes": [ "513210" ], "sic_codes": [ "7372" ], "keywords": [ "orthodontic software", "patient reminders", "online booking" ], "customer_types": [ "B2B" ], "customer_segments": [ "smb" ], "compliance": [ "HIPAA" ], "technologies": [ "stripe", "aws", "intercom" ], "vendors": [ "aws", "stripe" ], "employees": "11-50", "employee_count": 38, "revenue": "1m-10m", "location": { "country_code": "US", "country": "United States", "state": "Colorado", "city": "Denver" }, "office_locations": [ { "country_code": "US", "country": "United States", "state": "Colorado", "city": "Denver", "employee_count": 38 } ], "parent": null, "subsidiaries": [], "socials": { "linkedin_url": "https://www.linkedin.com/company/bracehub", "twitter_url": null, "facebook_url": null, "youtube_url": null, "github_url": null }, "open_jobs": 2, "web": { "traffic_rank": 402118 }, "icp": "BraceHub provides online booking, reminders and two-way messaging for orthodontic and dental practices. They reduce no-shows and front-desk phone time. Their customers are likely independent orthodontists and small dental groups in the US." } ], "not_found": [ "not-a-real-company.example" ], "usage": { "charged": { "lookups": 2, "discoveries": 0 }, "already_paid": 0, "remaining": { "lookups": 9748, "discoveries": 1977 } }}Get a company GET
Basic company information is always returned. Long paragraphs are off by default; turn them on with `show_icp=true` (what they do and who they sell to), `show_pricing=true` (pricing page summary), `show_description=true` (long description) and `show_pages=true` (the most useful pages on their website, with URLs). Costs 1 lookup, free if the company is already paid for this billing month. Field meanings are on the Companies & IDs page.
Get a page summary GET
The summary of one page on a company's website, with its URL. Summaries are AI-written from the page. Costs 1 lookup, free if the company is already paid for this billing month. If we don't have that page type for the company you get a 404 that lists the page types we do have; it isn't charged.