The examples below demonstrate some of the most common requests you’ll make using the SERPtag REST API. All requests return JSON and require a valid API key.

Base URL https://serptag.com/api

Authentication Replace sk_live_your_key_here with your own API key before running these examples.

Get All Projects

Retrieve every project associated with your SERPtag account.

cURL

curl -H "X-API-Key: sk_live_your_key_here" \
https://serptag.com/api/projects/

JavaScript

const response = await fetch("https://serptag.com/api/projects/", {
  headers: {
    "X-API-Key": "sk_live_your_key_here"
  }
});

const projects = await response.json();

console.log(projects);

Python

import requests

response = requests.get(
    "https://serptag.com/api/projects/",
    headers={
        "X-API-Key": "sk_live_your_key_here"
    }
)

print(response.json())

Get Project Details

Retrieve detailed information for a single project. Replace 123 with your own project ID.

curl -H "X-API-Key: sk_live_your_key_here" \
https://serptag.com/api/projects/123/

Get Project Keywords

Retrieve every tracked keyword for a project. Replace 123 with your project ID.

curl -H "X-API-Key: sk_live_your_key_here" \
"https://serptag.com/api/project-keywords-list/123/?limit=200&offset=0"

Get Keyword Details

Retrieve information for a single tracked keyword. Replace 456 with your keyword ID.

curl -H "X-API-Key: sk_live_your_key_here" \
https://serptag.com/api/keyworddata/456/

Get Keyword Ranking History

Retrieve historical ranking data for a keyword. Replace 123 with your project ID and 456 with your keyword ID.

curl -H "X-API-Key: sk_live_your_key_here" \
https://serptag.com/api/project-keyword-history/123/456/

Get Keyword Search Volume History

Retrieve historical search volume data for a keyword.

curl -H "X-API-Key: sk_live_your_key_here" \
https://serptag.com/api/keyword-volume-history/456/

Get Project Performance Graph

Retrieve project graph data for a specific date range.

curl -H "X-API-Key: sk_live_your_key_here" \
"https://serptag.com/api/project-keyword-graph/123/?start_date=2025-01-01&end_date=2025-12-31"

Dates must use the format:

YYYY-MM-DD

Get Top 10 Keywords

Retrieve every keyword currently ranking between positions 1 and 10.

curl -H "X-API-Key: sk_live_your_key_here" \
https://serptag.com/api/projects/top-10-keywords/

Typical Workflow

Most applications follow a similar process when working with the SERPtag REST API.

Get Projects
      ↓
Choose a Project
      ↓
Retrieve Keywords
      ↓
Get Keyword Details
      ↓
Retrieve History or Graph Data

For example:

Retrieve your projects using /projects/.
Select a project ID.
Retrieve keywords using /project-keywords-list/{project_id}/.
Use the returned keyword IDs to retrieve rankings, history, and search volume.

Common Use Cases

Custom SEO Dashboards

Build internal dashboards by combining:

/projects/
/project-keywords-list/
/project-keyword-history/

Automated Reports

Generate scheduled SEO reports using:

/projects/stats/
/project-keyword-graph/

Perfect for weekly and monthly reporting.

Client Reporting

Export ranking data into tools such as:

Looker Studio
Google Sheets
Power BI
Internal reporting systems

Useful endpoints include:

/keyworddata/
/keyword-volume-history/
/projects/top-10-keywords/

Data Backups

Export your ranking data by combining:

/project-keywords-list/
/project-keyword-history/

This makes it easy to archive historical rankings.

Best Practices

For the best experience when integrating with the SERPtag REST API:

Store API keys securely using environment variables.
Never commit API keys to source control.
Cache project and keyword data whenever possible.
Handle 401 Unauthorized and 429 Too Many Requests responses gracefully.
Use pagination (limit and offset) when retrieving large keyword lists.

Interactive API Documentation

You can also explore the REST API directly from your SERPtag dashboard. Navigate to: Settings → API Details → Documentation The interactive documentation includes:

Live endpoint testing
Project picker
Keyword picker
Example requests
Example responses

📧 Email: support@serptag.com

MCP

API

Resources

Examples

Get All Projects

cURL

JavaScript

Python

Get Project Details

Get Project Keywords

Get Keyword Details

Get Keyword Ranking History

Get Keyword Search Volume History

Get Project Performance Graph

Get Top 10 Keywords

Typical Workflow

Common Use Cases

Custom SEO Dashboards

Automated Reports

Client Reporting

Data Backups

Best Practices

Interactive API Documentation

​Get All Projects

​cURL

​JavaScript

​Python

​Get Project Details

​Get Project Keywords

​Get Keyword Details

​Get Keyword Ranking History

​Get Keyword Search Volume History

​Get Project Performance Graph

​Get Top 10 Keywords

​Typical Workflow

​Common Use Cases

​Custom SEO Dashboards

​Automated Reports

​Client Reporting

​Data Backups

​Best Practices

​Interactive API Documentation

Get All Projects

cURL

JavaScript

Python

Get Project Details

Get Project Keywords

Get Keyword Details

Get Keyword Ranking History

Get Keyword Search Volume History

Get Project Performance Graph

Get Top 10 Keywords

Typical Workflow

Common Use Cases

Custom SEO Dashboards

Automated Reports

Client Reporting

Data Backups

Best Practices

Interactive API Documentation