Skip to main content

Serpstat API

Access all Serpstat data programmatically via JSON-RPC 2.0. Automate keyword research, backlink analysis, and domain metrics in your own tools and dashboards.

Written by Mike

Programmatic Access to All Serpstat Data

Serpstat API gives you direct access to all platform data — domain metrics, keyword rankings, backlink profiles, site audit results, and more — via a JSON-RPC 2.0 interface. Use it to automate data extraction, build custom dashboards, and integrate Serpstat into your own tools. API access is available from the Team plan.

What you can achieve:

  • Automate data extraction: Pull keyword rankings, backlink profiles, domain metrics, and audit results directly into your tools or scripts without manual exports.

  • Scale your workflows: Run batch queries across hundreds of domains or keywords — the Agency plan supports up to 2,000,000 API requests per month.

  • Integrate with your stack: Connect Serpstat data to Google Sheets, Looker Studio, Python scripts, R packages, or any system that accepts HTTP JSON-RPC calls.

Getting Started

  1. Make sure you have an active Team or Agency plan — API access is available from the Team plan.

  2. Go to your Serpstat profile settings and generate your personal API token. One token per user account.

  3. Open the full API reference at api-docs.serpstat.com — it covers all available methods, parameters, and response schemas.

  4. Send a POST request to the API endpoint using JSON-RPC 2.0 format: include your token, the method name, and the required parameters.

  5. Monitor your API credit usage in Profile → Credits and Subscriptions — each row returned in the response counts as one credit.

Key Metrics Explained

  1. API requests per month: Number of API calls available on your plan. Team plan: 200,000/month. Agency plan: 2,000,000/month. Individual plan: no API access.

  2. Rows per response: Each row returned in an API response costs one credit. The Summary report costs 5 credits per call. Maximum 60,000 rows per request.

  3. API token: Your personal authentication key. Generate or renew it in Profile → Settings. One token per user account — no sandbox environment is available.

  4. JSON-RPC 2.0: The protocol used by the Serpstat API. Send POST requests with a method name and params object; receive a structured JSON response.

Pro Tip: Use a Sub-Account for Development and Testing

Avoid spending your main API credits while building integrations — isolate development work in a controlled sub-account.

  1. Go to Profile → Team Management and add a new team member with a separate email address.

  2. Allocate a small number of API credits to that sub-account — enough for testing without risking your main credit pool.

  3. Use the sub-account's API token for all development and integration testing.

  4. Switch to your main account token only when the integration is ready for production.

⚠️ Important: There is no sandbox for the Serpstat API: all requests run against live data and use credits. Use a test sub-account with limited credits during development, or contact us in chat to request test API access.

❓ Frequently Asked Questions

Q: Which plan includes API access? ✏️
​A: API access is available from the Team plan: Team includes 200,000 API credits per month, Team x2 includes 400,000, and Agency includes 2,000,000. The Individual plan does not include API access. See the full plan comparison on the Pricing page.
​

Q: Where is the full API documentation?
​A: The complete API reference — all methods, parameters, response formats, and code examples — is available at api-docs.serpstat.com.
​

Q: How are API credits counted? ✏️
​A: In most methods, each row in the API response costs one credit. Every request costs at least one credit, even if the response is empty. Some methods have a fixed cost: the Summary report costs 5 credits per call, and a single-page audit costs 10 credits. Rank Tracker read methods do not use credits. The exact cost is listed at the top of each method page in the API documentation.
​

Q: Do unused API credits roll over to the next month?
​A: No. API credits renew every month, and unused credits do not carry over. The daily query limit applies only to the web interface. The API is limited only by your monthly credits and your plan's rate limit.
​

Q: What are the API rate limits? ✏️
​A: Team and Team x2: 1 request per second. Agency: 10 requests per second. Each method returns up to 60,000 rows. If you need more, contact us in chat, and we will find a solution for your case.
​

Q: Can I use the API with my own scripts or AI agents?
​A: Yes. The API is built for automation: your scripts and AI agents can request Serpstat data directly with your API token. You can use the data internally and in reports for your clients. Embedding, reselling, or showing raw Serpstat data inside a customer-facing product or dashboard requires a separate data licensing agreement. Contact us in chat to discuss the terms.
​

Q: Can I get data for a specific country?
​A: Yes. Set the search engine database in the se parameter of each request — for example, g_nl for Google Netherlands. The full list of databases is in the API documentation.
​

Q: What data is available through the API?
​A: Keyword research data (search volume, keyword difficulty, CPC, competition, SERP), domain and URL analysis (organic keywords, competitors, top pages, visibility history), backlink data (backlinks, referring domains, anchors), keyword and content gap reports, Site Audit, and Rank Tracker data. The full list of methods is in the API documentation.
​

Q: How fresh is the API data?
​A: The API returns data from Serpstat databases, not live search results. Keyword databases are updated continuously on a rolling basis. Update frequency may vary by region and database. If you need live search results on demand, see SERP API, available on request.
​

Q: Is there a test environment or trial access to the API?
​A: There is no separate sandbox: all requests run against live data and use credits. To evaluate the data before you buy, contact us in chat. Our team will help you get test API access or trial credits.
​

Q: Are API-only packages available?
​A: Yes, on request. Contact us in chat with your expected monthly request volume, and our team will prepare an offer.
​

Q: Can I connect Serpstat to AI assistants and automation tools?
​A: Yes. The Serpstat MCP server connects Claude and other MCP-compatible assistants. In ChatGPT, use the Serpstat SEO Tool GPT. For n8n, install the Serpstat node. Other tools, such as Make, can call the API with a standard HTTP request.

Next Steps

  • Serpstat API Documentation — Full reference for all API methods, parameters, and response schemas.

  • Serpstat for Google Sheets — Run batch keyword and domain analysis directly inside Google Sheets using the Serpstat add-on.

  • Serpstat for R — Pull Serpstat API data directly into R for advanced statistical analysis and custom reporting.

Did this answer your question?