Get a company
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.
bearerAuthAuthorizationBearer <token>Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.
company*stringThe company's domain (for example stripe.com) or its CompanySpec id (for example cmp_8f2k1).
show_icp?booleanInclude icp: what they do, the problem they solve and who they sell to.
falseshow_pricing?booleanInclude pricing: a summary of their pricing page (plans, prices, free trial).
falseshow_description?booleanInclude long_description.
falseshow_pages?booleanInclude pages: the most useful pages on their website, with URLs. Get the summary of any of them with GET /companies/{company}/pages/{page_type}.
falseThe company.
application/json- response
company*usage*What this request cost and what is left this billing month.
curl -X GET 'https://api.companyspec.com/v1/companies/acmedental.io'{ "company": { "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.", "pricing": "Three plans billed per location per month, from $199 (Starter) to $499 (Pro), with custom pricing for groups of 10+ locations. A 30-day free trial is offered and onboarding is included on annual plans.", "pages": [ { "page_type": "home", "url": "https://acmedental.io" }, { "page_type": "pricing", "url": "https://acmedental.io/pricing" }, { "page_type": "legal", "url": "https://acmedental.io/privacy" } ] }, "usage": { "charged": { "lookups": 1, "discoveries": 0 }, "already_paid": 0, "remaining": { "lookups": 9749, "discoveries": 1977 } }}Resolve a company GET
Turn a name, domain or LinkedIn URL into a company. Returns the best match and, if you ask for them with `limit`, up to 4 alternatives (fewer if there aren't that many good candidates). Use it to get the domain to pass to other endpoints. Provide at least one of `name`, `domain` or `linkedin_url`. `confidence` (0–1) says how sure we are. Above 0.8 is usually right; below 0.5, check the alternatives. `match` is `null` when nothing is close enough. Free. Limited to 60 requests per minute.
Enrich companies in bulk POST
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`.