Google SERP, TOP 100 results (URL + Snippet), website rankings

  • API is accessible at the following address https://online.seranking.com/structure/clientapi/positions/?method=METHOD_NAME
  • Access is available over HTTP protocol
  • All the incoming and outgoing data is in UTF-8 coding, any result of any method execution comes as a JSON-encoded string
  • All the methods accept both GET and POST parameters
  • All the parameters are required unless other is specified
  • While calling any method except login, it is necessarily to pass token parameter aquired at the authorization.

Authorization (method login)

Parameters:

  • login - login
  • pass - md5 for the password
Response sample:
{ "name":"name1 name2", "token":"c3b7ce7ae4cce5a6312f4046b701da9d", "avatar": "http://online.seranking.com/tmp/avatar/upload-icon.png" }

Call sample: https://online.seranking.com/structure/clientapi/positions/?method=login&login=LOGIN&pass=HASH

Adding a query (addTask)

Parameters:

  • query - query
  • engine_id - unique identificator of the search engine (full list can be found in the method getEngines)
  • region_name - region name (optionally, for the Google Search engine only)
  • region_id - unique region identificator (required for Yandex search engines, full list can be found at the method getYandexRegions)
Response sample:
{"task_id" : 12345 }

Call sample: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=addTask&query=QUERY&engine_id=ID_SEARCH_ENGINE

Adding group queries (addTasks)

Parameters:

  • query - array of queries
  • region_name - region name (optionally, for the Google Search engine only)
  • engine_id - unique identificator of the search engine (full list can be found in the method getEngines)
  • region_id - unique region identificator (required for Yandex search engines, full list can be found at the method getYandexRegions)
Response sample:
{"task_ids":[4,5],"total_added":2}

Call sample: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=addTasks&queries[]=QUERY1&queries[]=QUERY2&engine_id=ID_SEARCH_ENGINE

Checking the query processing status (checkTaskStatus)

Parameters:

  • task_id - unique query identificator
Response sample:
{"status" : 0 }

Call sample: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=checkTaskStatus&task_id=ID_QUERY

List of the allowed Search Engines (getEngines)

The method does not require parameters

Response sample:
        {"engines":
            {
                "201":"Google Andorra",
                "202":"Google United Arab Emirates",
                 ...
                "378":"Google Serbia",
                "339":"Google Russia"
            }
        }
    

Call sample: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=getEngines

List of the allowed Yandex regions (getYandexRegions)

The method does not require parameters.

Response sample:
      {
        "regions":
        {
            "213":"Moscow",
            "90":"San Francisco",
            "2":"Saint Petersburg",
            "10174":"Saint Petersburg and the Leningradskaya oblast",
            ...
        }
      }
    

Call request: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=getYandexRegions

Aquiring results for the previously added task (getTaskResults)

Method returns error if task is not finished

Parameters:
  • task_id - unique query identificator
Response samples:
        {
        "results": [
        {
            "position": "1",
            "url": "https:\/\/www.pizzahut.com\/",
            "title": null,
            "snippet": "<span>Order pizza online for fast pizza delivery or drop by for carryout. You may also 
\ncontact Pizza Hut and find out about our catering services for your next big event.<\/span>" }, { "position": "2", "url": "https:\/\/www.dominos.com\/", "title": null, "snippet": "<span>Domino's Home Page - Domino's Pizza, Order Pizza Online for Delivery -
\nDominos.com.<\/span>" }, ... ] }

Call request: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=getTaskResults&task_id=ID_QUERY

List of all the queries of the user (getTasks)

The method does not require parameters.

Response sample:
    {
    "tasks": [
        {
            "id": "1",
            "query": "Query1",
            "region_name": null,
            "engine_id": "200",
            "region_id": "0",
            "added": "2016-01-18 13:11:29",
            "is_completed": "1"
        },
        {
            "id": "2",
            "query": "Query2",
            "region_name": "New York",
            "engine_id": "200",
            "region_id": "0",
            "added": "2016-01-19 10:07:56",
            "is_completed": "1"
        },
        ...
    }
    

Call sample: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=getTasks

Session close (logout)

Parameters:

  • token - token parameter aquired at the authorization

Call sample: https://online.seranking.com/structure/clientapi/positions/?token=TOKEN&method=logout

Request cost:

$0.006

Ask Us a Question
or Leave Some Feedback!

I've been using SE Ranking for tracking my progress in getting to the first page of Google for Qeryz for my target keywords. It's done a phenomenal job of keeping itself accurate - which sets it apart from all other rank tracking tools I've used in the past. That alone is reason enough for me to use and stay with SE Ranking amongst other things. people Sean Si from Qeryz.com
SEranking is my favorite tool for tracking daily changes in SERP rankings, including localized rankings. Especially the possibility to re-check on request is very nice. Next to that, the Website Audit is very helpful for tracking on-page SEO issues. people Simon Kloostra from Joomlaseo.com
So when I learned about SE Ranking, and tried it for our clients, I couldn't help but use and recommend it to our audience by writing a review about it. Such a promising tool! people Pam Sallegue of SEO-Hacker
Content marketing is a key component of my marketing strategy. I want to create content that is relevant, engaging and ranks well. SE Ranking enables me to carry out keyword research and ensure my content is as effective as possible. people Paul Boag from Boagworld.com
SE Ranking is my go-to rank tracking tool after years of trying to finding the right tool. It's easy to use and has all the features I need to keep on top of my rankings. people Adam Connell from Bloggingwizard.com
I’ve been using SE Ranking for 4 months now and it is now an important tool in my arsenal of blogging tools. It’s powerful and lets me track my rankings for keywords on Successful Blogging. I’ve been pleased with the support that they give you and the quality of SE Ranking. people Sue Anne Dunlevie from Successfulblogging.com
I’ve been lucky enough to get an early access to SE Ranking and found it really user-friendly. I am very busy and I need to save time and SE Ranking is perfect for that: Setting up a site takes minutes and everything is very easy and fast to find. I just love those rankings reports SE Ranking sends every week or month. No need to login to check the rankings: You get your rankings in your email inbox and can continue working. people Ann Smarty from viralcontentbuzz.com
All aboard! I brought my clients over to SE Ranking. I thought I would have never left my old KW tracking software, but guess what? I outgrew it. To all marketing agencies, start selling content marketing packages like we have. Record keyword rankings & monitor backlinks within one software. Nice keyword suggestion tool too. Thanks SE Ranking. people Francisco Meza from planetmarketing.com