Create a rank tracker

Embed

<a href="https://seolyticize.com/docs/ref-create-rank-tracker"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/9d082100-6dc4-41f1-bfdc-fd7124010d0e/social-card.svg?v=3e7ae33eec8b" alt="Create a rank tracker" width="600" height="315"></a>

POSThttps://seolyticize.com/api/v1/tools/create_rank_tracker

Starts tracking a client's positions on one engine, device and locale. Answers 'track this client on Bing too' or 'track mobile separately'. Defaults to the client's first project and site domain. Engine and locale cannot be changed later — they are part of every keyword's identity — so a different market is a new tracker.

Request body application/json

clientIdstringrequired

namestringrequired

projectIdstring

domainstring

enginestring

devicestring

desktop | mobile | both = desktop

frequencystring

daily | weekly = daily

locationCodeinteger

languageCodestring

{
  "clientId": "string",
  "name": "string",
  "projectId": "string",
  "domain": "string",
  "engine": "google",
  "device": "desktop",
  "frequency": "daily",
  "locationCode": 0,
  "languageCode": "string"
}

Code samples

cURL

curl -X POST "https://seolyticize.com/api/v1/tools/create_rank_tracker" \
  -H "Content-Type: application/json" \
  -d '{"clientId":"string","name":"string","projectId":"string","domain":"string","engine":"google","device":"desktop","frequency":"daily","locationCode":0,"languageCode":"string"}'

TypeScript

const res = await fetch('https://seolyticize.com/api/v1/tools/create_rank_tracker', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"clientId":"string","name":"string","projectId":"string","domain":"string","engine":"google","device":"desktop","frequency":"daily","locationCode":0,"languageCode":"string"}),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "POST",
    "https://seolyticize.com/api/v1/tools/create_rank_tracker",
    headers={
    "Content-Type": "application/json",
    },
    json={"clientId": "string", "name": "string", "projectId": "string", "domain": "string", "engine": "google", "device": "desktop", "frequency": "daily", "locationCode": 0, "languageCode": "string"},
)
data = res.json()

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://seolyticize.com/api/v1/tools/create_rank_tracker", strings.NewReader(`{"clientId":"string","name":"string","projectId":"string","domain":"string","engine":"google","device":"desktop","frequency":"daily","locationCode":0,"languageCode":"string"}`))
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://seolyticize.com/api/v1/tools/create_rank_tracker');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"clientId":"string","name":"string","projectId":"string","domain":"string","engine":"google","device":"desktop","frequency":"daily","locationCode":0,"languageCode":"string"}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://seolyticize.com/api/v1/tools/create_rank_tracker')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"clientId":"string","name":"string","projectId":"string","domain":"string","engine":"google","device":"desktop","frequency":"daily","locationCode":0,"languageCode":"string"}'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts res.body

Java

import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://seolyticize.com/api/v1/tools/create_rank_tracker"))
    .header("Content-Type", "application/json")
    .method("POST", BodyPublishers.ofString("{\"clientId\":\"string\",\"name\":\"string\",\"projectId\":\"string\",\"domain\":\"string\",\"engine\":\"google\",\"device\":\"desktop\",\"frequency\":\"daily\",\"locationCode\":0,\"languageCode\":\"string\"}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Responses

200 The tool's result, under data.

Example

{
  "data": {}
}

Schema

datarequired

400 The body was not JSON or did not match the tool's input schema.

Example

{
  "error": "string"
}

Schema

errorstringrequired