Skip to main content
The SERPtag REST API gives developers direct access to their SEO data through simple HTTP requests. Retrieve projects, keyword rankings, ranking history, search volume, alerts, and account information to power your own applications, dashboards, reports, or integrations. All responses are returned as JSON, making the API easy to integrate into any programming language or framework.
Base URL https://serptag.com/api

​
What You Can Do

Using the REST API, you can:
  • Retrieve all of your rank tracking projects
  • Fetch keyword rankings, search volume, ranking URLs, and position changes
  • View keyword ranking history over time
  • Access historical search volume data
  • Retrieve project performance graphs
  • View account information and subscription limits
  • Export data into your own dashboards, BI tools, or reporting systems
The current REST API is read-only, allowing you to safely access your SEO data without modifying your account.

​
Requirements

Before making requests to the REST API, you’ll need: The same API key works for both the REST API and the SERPtag MCP Server.

​
Making Your First Request

After creating your API key, you can immediately retrieve your projects.
If authentication succeeds, the API returns a JSON response containing your projects.

​
Authentication

Every request must include your SERPtag API key.

​
Option 1 — X-API-Key

​
Option 2 — Bearer Token

For more details, see the Authentication guide.

​
REST API vs MCP

Both products access the same SERPtag data, but they are designed for different workflows. Use the REST API when you’re writing code. Use SERPtag MCP when you want an AI assistant to answer SEO questions using your live SERPtag data.

​
Common Use Cases

The REST API is commonly used to:
  • Build custom SEO dashboards
  • Generate automated client reports
  • Sync rankings with CRM platforms
  • Export data into Looker Studio
  • Build internal reporting tools
  • Connect SERPtag with third-party applications

​
Current Limitations

The public REST API is currently read-only. You can retrieve:
  • Projects
  • Keywords
  • Ranking history
  • Search volume history
  • Project graphs
  • Alerts
  • Account information
You cannot currently:
  • Create projects
  • Add keywords
  • Refresh rankings
  • Delete data
  • Update alerts
These capabilities are planned for a future release.

​
Need Write Access?

Write endpoints are currently in development. Future releases will include support for:
  • Create Projects
  • Add Keywords
  • Refresh Rankings
  • Generate Reports
If your business requires write access today, please contact the SERPtag team.

​
Next Steps

Continue exploring the REST API:
  • Authentication — Learn how to authenticate every request.
  • Endpoints — Browse every available API endpoint.
  • Examples — Ready-to-use examples in cURL, JavaScript, Python, and PHP.
You can also explore the interactive API documentation from your SERPtag dashboard under: Settings → API Details → Documentation

​
Need Help?

If you have questions about the REST API or need assistance with your integration, visit the rest of the developer documentation or contact the SERPtag support team.