Skip to Content
CompanySpec
API referenceCompany data

Get a page summary

GET
/companies/{company}/pages/{page_type}

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.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.

Path Parameters

company*string

The company's domain (for example stripe.com) or its CompanySpec id (for example cmp_8f2k1).

page_type*string

One of the page types listed on the Page types page.

Value in"home""pricing""about""careers""blog""legal""integrations""case_studies""login""status""engineering""support""cart""compliance"

Response Body

The page summary.

application/json
  1. response
page*
usage*

What this request cost and what is left this billing month.

Example Request
curl -X GET 'https://api.companyspec.com/v1/companies/acmedental.io/pages/pricing'
Example Response
{  "page": {    "page_type": "pricing",    "url": "https://acmedental.io/pricing",    "summary": "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."  },  "usage": {    "charged": {      "lookups": 0,      "discoveries": 0    },    "already_paid": 1,    "remaining": {      "lookups": 9750,      "discoveries": 1977    }  }}

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`.

Get technologies GET

Every technology we have detected for the company: where we found it (`website` or `jobs`), when it was first seen and, if they stopped using it, when. `explanation` says in plain words what we found. Costs 1 lookup, free if the company is already paid for this billing month.