Get position distribution

Embed

<a href="https://seolyticize.com/docs/ref-get-position-distribution"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/0c2b712e-3ff4-46e5-9f5b-c05271854c97/social-card.svg?v=3e7ae33eec8b" alt="Get position distribution" width="600" height="315"></a>

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

How a tracker's keywords spread across positions 1-3, 4-10, 11-20, 21-50 and 51-100 each day, with average position and visibility, per device. Answers 'how many keywords are on page one, and is that growing'. Keywords read and not found are counted as not ranking, apart from every band; keywords not read that day are counted as not captured. The average is over ranking keywords only.

Request body application/json

clientIdstringrequired

trackerIdstringrequired

daysinteger

= 30

devicestring

desktop | mobile

{
  "clientId": "string",
  "trackerId": "string",
  "days": 30,
  "device": "desktop"
}

Code samples

cURL

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

TypeScript

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

Python

import requests

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

package main

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

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

Ruby

require 'net/http'
require 'uri'

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