Getting started with the API
Use JustRanks data in your own tools: create an API key in Settings, send it as a Bearer token, and read search results, rankings and your markets as JSON.
The JustRanks API gives you the same data and the same numbers as the app: the organic search results of every keyword in the database, rankings over any period, product families, product page history for your own products and key competitors, and your markets and signals. It is included in All Access and in the free trial.
Create an API key
Open API & MCP in your account menu, go to API keys, give the key a name (for example "Reporting script") and create it. The key is shown once. Copy it and store it like a password. Keys belong to your organization, not to a person, and only the owner can create or revoke them. Revoking a key stops it within a minute.
Your first request
Every request goes to https://www.justranks.com/api/v1 and sends the key in the Authorization header. Use the www address: the address without www redirects, and many tools drop the key on a redirect.
curl -H "Authorization: Bearer jr_live_…" \
"https://www.justranks.com/api/v1/keywords/dog%20crate/serp"
The answer is JSON. Successful answers have a data object and often a meta object (period, marketplace). Prices are in dollars, ratings in stars (4.6), dates in YYYY-MM-DD.
Limits
Keywords in your own markets are unlimited. For the rest of the database there is a daily allowance, so the API stays fast and affordable for everyone. Asking for the same keyword again on the same day does not count twice, keywords that are not in the database do not count, and an ASIN search without results does not count either.
| All Access | Trial | |
|---|---|---|
| Keywords in your markets | unlimited | unlimited |
| Other keywords per day | 2,500 | 250 |
| ASIN searches per day | 500 | 50 |
| New keywords for the database per 24 hours | 500 | 500* |
| Analyses per minute | 60 | 60 |
| Other requests per minute | 120 | 120 |
* Trial accounts also share a common daily limit for new keywords. Adding keywords counts the last 24 hours, not the day in UTC, and keywords that are already tracked do not count.
The daily allowance resets at 00:00 UTC. Analyses run one after another per account: send the next request when the previous one has answered. GET /api/v1/usage shows what you have used today and your current limits; the same numbers appear at the top of the API & MCP page in the app.
Market limits are the same as in the app: up to 100 keywords, 10 of your own products and 3 key competitors per market.
Headers
Every answer carries the per-minute limit in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Answers that use the daily allowance add X-Quota-Keywords-Remaining or X-Quota-Asins-Remaining and X-Quota-Reset.
Errors
Errors have a fixed shape with a code you can check in your code and a message you can show:
{ "error": { "code": "trial_limit_reached", "message": "Your trial includes 250 keywords per day outside your markets. …", "upgrade_url": "…" } }
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | A parameter is missing or wrong. |
| 401 | missing_api_key, invalid_api_key | No key sent, or the key was revoked. |
| 402 | subscription_required | The trial ended or the subscription is not active. |
| 403 | not_in_your_markets | Product page history is only available for products in your markets. |
| 404 | keyword_not_found, no_capture, not_found | The keyword is not in the database yet, has no capture for that day, or the market does not exist. |
| 429 | rate_limited, busy | Too many requests. Wait for Retry-After seconds and try again. |
| 429 | daily_limit_reached, trial_limit_reached | The daily allowance is used up. It resets at 00:00 UTC. |
| 429 | keyword_add_limit_reached | No new keywords left for the last 24 hours. Trial accounts get trial_limit_reached. |
| 503 | unavailable | Temporarily unavailable. Retry shortly. |
Fair use
Use the data for your own work: your own analyses, internal tools and automations, and reports for your own clients. Reselling the data, publishing it as a dataset or running a competing product on it is not allowed. If you want to build a product on JustRanks data, contact us about a commercial license.