Skip to Content
CompanySpec
API referenceDiscovery

List a vendor's customers

POST
/vendors/{vendor}/customers

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

Authorization

bearerAuth
headerAuthorizationBearer <token>

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

Path Parameters

vendor*string

Slug of a technology or service provider, from /technologies (for example openai, aws, stripe).

Request Body

application/json
  1. body
source?string

Where it must have been found: subprocessor list, website, jobs, or any.

Default"any"
Value in"subprocessor""website""jobs""any"
company?

Only return companies that match these filters.

limit?integer
Range1 <= value <= 100
Default25
cursor?string

The next_cursor from the previous page. Valid for 24 hours.

Response Body

Companies using the vendor.

application/json
  1. 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.

Example Request
curl -X POST 'https://api.companyspec.com/v1/vendors/openai/customers' \  -H 'Content-Type: application/json' \  -d '{  "source": "subprocessor",  "company": {    "countries": [      "GB"    ],    "employees": [      "11-50",      "51-200"    ]  },  "limit": 25}'
Example Response
{  "results": [    {      "company": {        "id": "cmp_7tw3e",        "domain": "ledgerly.co.uk",        "name": "Ledgerly",        "logo_url": null      },      "sources": [        "subprocessor"      ],      "evidence_url": "https://ledgerly.co.uk/legal/subprocessors"    }  ],  "next_cursor": "c_2",  "usage": {    "charged": {      "lookups": 0,      "discoveries": 1    },    "already_paid": 0,    "remaining": {      "lookups": 9750,      "discoveries": 1976    }  }}

Search page summaries POST

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.

List a company's job postings GET

Job postings of one company, newest first. Open postings by default; pass `status=closed` or `status=all` to include postings that have closed. Costs 1 lookup unless the company is already paid for this billing month; all of its postings are then free.