Authentication
How to authenticate with the RankParse API using API keys.
API Keys
All API requests require an API key passed in the X-API-Key header.
curl "https://api.rankparse.com/v1/backlinks?domain=example.com" \
-H "X-API-Key: rp_your_key_here"Creating API keys
- Log in to your dashboard
- Click "Create API Key"
- Copy the key immediately -- it is only displayed once
API keys follow the format rp_<32 random characters>.
Key security
- API keys are stored as SHA-256 hashes. We cannot recover a lost key.
- If a key is compromised, revoke it immediately from your dashboard and create a new one.
- Never commit API keys to version control. Use environment variables.
export RANKPARSE_API_KEY="rp_your_key_here"Error responses
| Status | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key |
402 | payment_required | Insufficient credits |
429 | rate_limited | Too many requests (60/min limit) |
{
"error": "unauthorized",
"code": "unauthorized",
"message": "Missing or invalid API key"
}