API & errors
Unexpected status codes, missing fields, timeouts or integration help with Clay, n8n or your own code.
SUPPORT
Talk to a person,
not a ticket queue.
Questions about the API, billing or your account? Email us. Every message is read by the people who build ProfileHunt.
Get a faster answer
Include these and we can usually fix it in one reply.
- 1
Request ID
Starts with req_. Open Usage, click the request, copy it from the top.
- 2
Profile URL
The LinkedIn link you sent, exactly as you sent it.
- 3
Account email
The email you sign in with, so we find your workspace fast.
- 4
What you expected
And what you got instead. A screenshot helps.
TOPICS
What do you need help with?
Billing & credits
Payments, receipts or a top-up that didn't arrive. Credits never expire, and failed lookups are never charged.
Account & team
Sign-in trouble, inviting teammates, roles, or a lost API key.
API ERRORS
What a response means
You only pay when a profile is found. Everything else on this list is free, so retrying never costs you twice.
| HTTP | Body | Meaning | Cost |
|---|---|---|---|
| 200 | "status": "ok" | Profile found and returned. | 1 credit |
| 200 | "status": "gone" | No public profile at this URL. | Free |
| 200 | "status": "unavailable" | LinkedIn didn't serve the profile at that moment. Retry later. | Free |
| 401 | unauthorized | The API key is missing, wrong or revoked. | Free |
| 402 | insufficient_credits | Your workspace is out of credits. Top up on the billing page. | Free |
| 422 | invalid_url | Not a LinkedIn profile URL. Use linkedin.com/in/… | Free |
| 429 | rate_limited | Over 60 requests a minute on this key. Wait for Retry-After, then continue. | Free |
| 502 | upstream_failed | We couldn't reach LinkedIn. Safe to retry. | Free |
| 503 | temporarily_unavailable | Busy right now. Wait for the Retry-After header, then retry. | Free |
| 504 | timeout | The lookup took too long. Safe to retry. | Free |