API
One REST API, keyed by company domain
Company Pulse events, hiring signals, open jobs, posted pay, public tenders, hotel rate curves, Shopify stores and review panels. JSON over HTTPS, described in OpenAPI 3.1, with an as-of date on every answer.
Quick start
- Base URL
https://api.arcadiumdata.io- Auth
Authorization: Bearer <key>orX-API-Key: <key>- Without a key
- 10 requests a minute, 100 a day per IP
- Errors
{"error": code, "message": text}
curl -s "https://api.arcadiumdata.io/v1/companies/example.com/pulse" \
-H "Authorization: Bearer $ARCADIUM_API_KEY"Get a key at /signup/ (or POST /v1/account/signup). Import openapi.json into Postman, Insomnia, Clay or an agent framework to get every route with its parameters and response schema.
Routes
Jobs
| Route | What it returns | Key |
|---|---|---|
GET /v1/jobs | Search open jobs | optional |
GET /v1/jobs/{id} | One job with its description | optional |
Companies
| Route | What it returns | Key |
|---|---|---|
GET /v1/companies/{domain} | Company profile: job boards, open jobs, hiring signals, tech, events, Shopify store | optional |
GET /v1/companies/{domain}/history | Point-in-time hiring history 2023 onwards (open jobs per crawl, from the public web archive) | optional |
POST /v1/coverage | Which of up to 50 company domains have a known public job board | optional |
GET /v1/company/{domain} | Primary job board and open-jobs snapshot of a company (prefer /v1/companies/{domain}) | optional |
GET /v1/company/{domain}/signals | Latest daily hiring signals of a company | optional |
GET /v1/events | Hiring events feed (market entry, ATS switch, surge, freeze, new department) | optional |
Pulse
| Route | What it returns | Key |
|---|---|---|
GET /v1/companies/{domain}/pulse | Company Pulse: dated change events of one company from every dataset (last 90 days) | optional |
GET /v1/pulse/events | Company Pulse feed: events of every company, filtered by day, country and type | optional |
Pay
| Route | What it returns | Key |
|---|---|---|
GET /v1/pay/bands | Posted-pay bands (p25 / median / p75, EUR) per country and ISCO-08 group | optional |
GET /v1/pay/transparency | Pay-transparency adoption: share of job ads stating pay, per country and day | optional |
Hotels
| Route | What it returns | Key |
|---|---|---|
GET /v1/hotels/rate-curve | Cities with a forward hotel-rate curve | optional |
GET /v1/hotels/rate-curve/{city} | Forward hotel-rate curve and demand index of a city (next 90 nights) | optional |
Shops
| Route | What it returns | Key |
|---|---|---|
GET /v1/shops/{domain} | Shopify store profile on a domain | optional |
GET /v1/shops/{domain}/apps | Apps detected on a Shopify store, with installs and uninstalls | optional |
Tenders
| Route | What it returns | Key |
|---|---|---|
GET /v1/tenders | Search public tenders and contract awards (EU TED, UK Find a Tender, FR/DE/PL/BG national boards) | optional |
Watchlists
| Route | What it returns | Key |
|---|---|---|
POST /v1/watchlists | Track a list of companies (needs an API key) | required |
GET /v1/watchlists | Your watchlists | required |
GET /v1/watchlists/{id} | One watchlist with its domains | required |
DELETE /v1/watchlists/{id} | Stop tracking a watchlist | required |
GET /v1/watchlists/{id}/changes | Company Pulse events and the latest hiring signals of the tracked companies | required |
Account
| Route | What it returns | Key |
|---|---|---|
GET /v1/plans | Plans, limits and prices | optional |
GET /v1/me | Your tier, plan, quota and usage | optional |
POST /v1/account/signup | Sign up: email a one-time link that shows a free API key | optional |
POST /v1/account/verify | Redeem the emailed link: returns the API key (once) | optional |
POST /v1/account/checkout | Upgrade: a Stripe Checkout link for Starter, Pro or Business | required |
GET /v1/account/portal | Billing portal link: invoices, card, plan change, cancel | required |
Reviews
| Route | What it returns | Key |
|---|---|---|
GET /v1/reviews/snapshot | Rating trajectory of tracked review listings | optional |
GET /v1/reviews/panel | Daily review velocity panel by ticker or name (derived metrics only) | optional |
Questions
Can I try the API without a key?
Yes. Without a key you get 10 requests a minute and 100 a day per IP, with pages of up to 10 rows. Watchlists need a key.
How do I authenticate?
Send the key as "Authorization: Bearer <key>" or as "X-API-Key: <key>". Every response carries rate-limit and quota headers.
Is there personal data in the API?
No. Every route returns company-level or aggregate data. Names, emails and phone numbers are removed before anything is stored, and free text is cleaned again on the way out.
How fresh is the data?
Sources are read daily. Every answer has an as-of date, and Company Pulse events carry both occurredAt (when it happened) and observedAt (when we first saw it).
Try it on your own accounts
The free plan tracks 100 company domains. Sign up, get the key at once, upgrade by card on your account page.