Get ranking URL swaps

Embed

<a href="https://seolyticize.com/docs/ref-get-url-swaps"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/edb9615c-e442-4de0-a771-629d30b738b9/social-card.svg?v=3e7ae33eec8b" alt="Get ranking URL swaps" width="600" height="315"></a>

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

Tracked keywords whose ranking page changed over a period — which page replaced which, when, and at what positions — flagging pages that take turns, and any keyword where several of the client's pages rank at once right now. Answers 'which keywords have two of our pages fighting over them'. Use it alongside get_cannibalization, which looks at one snapshot rather than across time.

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_url_swaps" \
  -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_url_swaps', {
  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_url_swaps",
    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_url_swaps", 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_url_swaps');
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_url_swaps')
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_url_swaps"))
    .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