Get news events
Company news events such as launches, expansions, executive hires and funding. Costs 1 lookup unless already paid for this billing month.
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).
category?stringA value from /values/news_categories.
within_days?integerOnly events from the last N days. Default 365.
1 <= value <= 730limit?integer1 <= value <= 10025cursor?stringThe next_cursor from the previous page. Valid for 24 hours. Fetching later pages charges for new companies on them.
News events.
application/json- response
news*array<>next_cursor*|Pass as cursor to get the next page. null when there are no more results.
usage*What this request cost and what is left this billing month.
curl -X GET 'https://api.companyspec.com/v1/companies/acmedental.io/news'{ "news": [ { "id": "nws_91ad2", "category": "launches", "category_group": "product", "date": "2026-09-30", "summary": "Launched an AI scheduling assistant for dental front desks.", "amount_usd": null, "url": "https://acmedental.io/blog/ai-scheduling-assistant" } ], "next_cursor": null, "usage": { "charged": { "lookups": 0, "discoveries": 0 }, "already_paid": 1, "remaining": { "lookups": 9750, "discoveries": 1977 } }}Get funding GET
Funding rounds, investors and acquisitions. Costs 1 lookup unless already paid for this billing month.
Count companies POST
How many companies match a search, and how many of them would be newly charged. Optionally break the total down by up to 3 fields with `group_by`. Takes the same filters as `/companies/search`, plus `min_score`, so you can check a search before you pay for it. Free. Counts stop at a cap: 10,000 for filter-only counts, and 1,000 when you use `semantic_query` (the most a search can return). `total_capped: true` means there are more than `total`; add filters to narrow it down. Counts have their own rate limit: 30 per minute on every plan, and 500 per day on the Free plan.