Quickstart

This quickstart shows the most common workflow: search for companies, reveal the accounts you care about, then export the list.

Step 1: Search companies

curl "https://api.primodato.com/v1/companies?industry=hospitality&country=US&tech=cloudbeds&limit=10" \
  -H "Authorization: Bearer $PRIMODATO_API_KEY"

Step 2: Reveal a company

Search results return masked company identity until you reveal a record. Reveal cost is returned by the API for the authenticated account, and reveals are idempotent per account.

curl -X POST https://api.primodato.com/v1/companies/cmp_01hxyz123abc/reveal \
  -H "Authorization: Bearer $PRIMODATO_API_KEY" \
  -H "Content-Type: application/json"

Step 3: Export results

Exports are asynchronous so larger datasets do not block your request lifecycle. Create the job first, then poll or download when the file is ready.

curl -X POST https://api.primodato.com/v1/exports \
  -H "Authorization: Bearer $PRIMODATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"industry":["hospitality"],"tech":["cloudbeds"]},"format":"csv"}'