Get Authenticated with the API
Use the api_key query parameter to automate requests. Included in every paid plan.
To start using the Scrupp API, sign up at app.scrupp.com and navigate to Settings → API Keys to generate your key. API keys come with every paid subscription from Starter up, and with lifetime deals that include the Enrichment Addon; the free plan and the trial do not include the API (the Claude connector works on every plan). Every request must carry that key in one of three ways — Authorization: Bearer, the X-API-Key header, or the api_key query parameter — and all three work on every endpoint, including status and result polling. Keep this key private — do not commit it to version control or expose it in client-side code. If your key is compromised, regenerate it immediately from the settings page. API calls are paid from your plan's monthly credits, at the same rates as the app.
Store your API key in environment variables or a secrets manager — never hard-code it into your application source. Rotate your key periodically by generating a new one in your account settings and updating all integrations. If you suspect your key has been leaked, regenerate it immediately to prevent unauthorized usage. Each API key is tied to your account's credit balance, so unauthorized access could consume your credits. For server-to-server integrations, restrict outbound requests to your API server's IP range when possible. Every key uses the same authentication mechanism; what differs between plans is the monthly credit allowance.
Requests are limited to 2,000 per minute per API key. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, so you can pace a bulk run without guessing. Exceeding the limit returns 429 with a Retry-After header and a retry_after field in the body — wait that many seconds and continue. The limit counts HTTP requests, not credits or records: one job that scrapes 10,000 rows is a single request.
Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEY
?api_key=YOUR_API_KEY
curl -X POST \
"https://api.scrupp.com/api/v1/contact/decision-maker/linkedin?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data '{ "company": "OpenAI" }'