Authentication

Every request to the JobsPipe API must include a valid API key. Keys are scoped to your account and meter usage against your plan.

Creating a key

In the dashboard, go to Settings → API Keys and click Generate API key. The key starts with jp_live_ and is shown only once - store it somewhere safe (a secret manager, not source control).

Full walkthrough: Manage API keys.

Using a key

Pass the key as a Bearer token on every request:

curl https://api.jobspipe.dev/v1/jobs/search \
  -H "Authorization: Bearer jp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "job_title_or": ["data analyst"] }'

curl https://api.jobspipe.dev/v1/jobs/search \
  -H "x-api-key: jp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "job_title_or": ["data analyst"] }'

Both headers are accepted; Authorization: Bearer is the convention we recommend.

Revoking a key

Open Settings → API Keys, find the key, and click Revoke. Revocation takes effect immediately - any request using that key starts returning 401.

Errors

See the error reference for full details and retry guidance, and rate limits & plans for the 429/402 thresholds.