Search page summaries
Search inside the summaries of company web pages, optionally limited to some page types and to companies
that match filters. Returns one result per company: its best-matching page. Sorted by match.score.
Costs 1 discovery per company returned that isn't already paid for this billing month.
bearerAuthAuthorizationBearer <token>Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.
application/json- body
query*stringWhat to look for in page summaries, in plain language. For example 14-day free trial, no credit card required.
length <= 500page_types?array<>Only search these page types. Default: all.
company?Only search pages of companies that match these filters.
limit?integerCompanies per page.
1 <= value <= 10025cursor?stringThe next_cursor from the previous page.
min_score?numberMinimum match.score (how well the page matches query).
0 <= value <= 1Matching pages.
application/json- response
results*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 POST 'https://api.companyspec.com/v1/pages/search' \ -H 'Content-Type: application/json' \ -d '{ "query": "14-day free trial, no credit card required", "page_types": [ "pricing" ], "company": { "countries": [ "GB" ] }, "limit": 20}'{ "results": [ { "company": { "id": "cmp_7tw3e", "domain": "ledgerly.co.uk", "name": "Ledgerly", "logo_url": null }, "page": { "page_type": "pricing", "url": "https://ledgerly.co.uk/pricing", "summary": "Three plans from £12 to £49 per month. All plans start with a 14-day free trial; no card required." }, "match": { "score": 0.91 } } ], "next_cursor": null, "usage": { "charged": { "lookups": 0, "discoveries": 1 }, "already_paid": 0, "remaining": { "lookups": 9750, "discoveries": 1976 } }}Find similar companies POST
Companies similar to 1–10 seed companies you pass in `companies`, based on what they do and who they sell to. All search filters work on top. Results are sorted by `match.score` (similarity to the seeds). The seeds are the examples you give us. They are never returned in the results and aren't charged. Seeds we can't find are ignored; if none are found you get a 404. Costs 1 discovery per company returned that isn't already paid for this billing month. `query` and `semantic_query` aren't accepted here: the seeds describe what you're looking for.
List a vendor's customers POST
Companies that use a technology or service provider: named in their subprocessor list, detected on their website, or mentioned in their job postings. Narrow the list with the same company filters as search. Larger companies come first. Costs 1 discovery per company returned that isn't already paid for this billing month. To check how many you'd get first, use the free `/companies/count` with `vendors` (subprocessor lists) or `technologies` (website and job postings).