GitHub - hilmanski/rank-tracker-api: Find the ranking position of your website across different search engines with this simple API.

About

Rank tracker API. Track your website rankings accross different search engines.

Interested in the step-by-step tutorial? Read this post: How to build a Rank Tracker API

Tech

• NodeJS (Express)
• SerpApi - to check the SERP ranking

Make sure to register at serpapi.com first to get your API Key.

Supported Search engines

• Google (max: 100th position)(read issue below)
• Bing (max: 50th position)
• DuckDuckGo (max: 30th position)

Ranking 0 means the domain is not found in the SERP until that max position.

Issue: Currently Google limited their searches to only 10 results per page.

Run locally

• Export your API Key

export SERPAPI_API_KEY=YOUR_ACTUAL_API_KEY

• Run server node index or nodemon index

Mini docs

• Endpoint: POST -> localhost:3000/api/rankings
• Parameters:
  • domain (string)
  • keywords (array[string])
  • engines ((array[name, params]))

Params inside engines can be any parameter that supported by SerpApi. Please refer to the documentation for more information.

Example usage

Simple sample

{
  "domain": "archive.org",
  "keywords": ["internet archive"],
  "engines": [
    {
      "name": "google",
      "params": {
        "domain": "google.com",
        "gl": "es"
      }
    }
  ]
}

Multiple engines

{
  "domain": "archive.org",
  "keywords": ["internet archive", "archived digital library"],
  "engines": [
    {
      "name": "google",
      "params": {
        "domain": "google.com",
        "gl": "es"
      }
    },
    {
      "name": "Bing",
      "params": {
        "cc": "gb"
      }
    }
  ]
}

cURL: No params sample

curl -X POST http://localhost:3000/api/rankings \
  -H 'Content-Type: application/json' \
  -d '{
    "keywords": ["internet archive"],
    "domain": "archive.org",
    "engines": [
      {
       "name": "google"
     }
    ]
  }'

cURL: Sample with params

curl -X POST http://localhost:3000/api/rankings \
  -H 'Content-Type: application/json' \
-d '{
    "keywords": ["internet archive", "digital library archived internet"],
    "domain": "archive.org",
    "engines": [
      {
        "name": "google",
        "params": {
            "google_domain": "google.co.id",
            "gl": "id"
        }
      }
    ]
  }'

Now

• Google ranking
• Bing ranking
• DuckDuckGo ranking
• Better output

Later

• Using env file instead of manual export
• Yahoo ranking (later) - we need to perform a pagination, since organic_results return is too little per page.