Track a keyword list

Embed

<a href="https://seolyticize.com/docs/ref-add-list-to-tracker"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/05429de9-d4f7-4e64-8180-79ae3a03a2a6/social-card.svg?v=3e7ae33eec8b" alt="Track a keyword list" width="600" height="315"></a>

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

Adds every keyword on a list to one of the client's rank trackers. Answers 'start tracking everything on that list'. Keywords for another country, language or engine than the tracker reads are skipped and listed with the reason, never tracked in the wrong market. Each added keyword is a paid lookup on every future run, so quote the tracker with estimate_cost afterwards if cost matters; refused when the plan's keyword allowance would be exceeded.

Request body application/json

clientIdstringrequired

trackerIdstringrequired

listIdstringrequired

{
  "clientId": "string",
  "trackerId": "string",
  "listId": "string"
}

Code samples

cURL

curl -X POST "https://seolyticize.com/api/v1/tools/add_list_to_tracker" \
  -H "Content-Type: application/json" \
  -d '{"clientId":"string","trackerId":"string","listId":"string"}'

TypeScript

const res = await fetch('https://seolyticize.com/api/v1/tools/add_list_to_tracker', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"clientId":"string","trackerId":"string","listId":"string"}),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "POST",
    "https://seolyticize.com/api/v1/tools/add_list_to_tracker",
    headers={
    "Content-Type": "application/json",
    },
    json={"clientId": "string", "trackerId": "string", "listId": "string"},
)
data = res.json()

package main

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

func main() {
	req, _ := http.NewRequest("POST", "https://seolyticize.com/api/v1/tools/add_list_to_tracker", strings.NewReader(`{"clientId":"string","trackerId":"string","listId":"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/add_list_to_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","trackerId":"string","listId":"string"}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://seolyticize.com/api/v1/tools/add_list_to_tracker')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"clientId":"string","trackerId":"string","listId":"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/add_list_to_tracker"))
    .header("Content-Type", "application/json")
    .method("POST", BodyPublishers.ofString("{\"clientId\":\"string\",\"trackerId\":\"string\",\"listId\":\"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