Queries just off the top, by page

Embed

<a href="https://seolyticize.com/docs/ref-striking-distance"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/f64688e6-1228-4304-957f-34bfce8bd533/social-card.svg?v=3e7ae33eec8b" alt="Queries just off the top, by page" width="600" height="315"></a>

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

Search Console queries where the client already ranks around positions four to twenty with meaningful impressions, grouped by the page that ranks. Each has the expected click-through rate now and at the top three from the measured click curve, the extra monthly clicks a move to third (and to first) would bring, and an opportunity score that favours queries nearest the top. Answers 'which existing pages should we improve first'. Read from stored console data; buys nothing. Null when the client has no site configured.

Request body application/json

clientIdstringrequired

daysinteger

= 28

minPositionnumber

= 4

maxPositionnumber

= 20

minImpressionsinteger

= 50

{
  "clientId": "string",
  "days": 28,
  "minPosition": 4,
  "maxPosition": 20,
  "minImpressions": 50
}

Code samples

cURL

curl -X POST "https://seolyticize.com/api/v1/tools/striking_distance" \
  -H "Content-Type: application/json" \
  -d '{"clientId":"string","days":28,"minPosition":4,"maxPosition":20,"minImpressions":50}'

TypeScript

const res = await fetch('https://seolyticize.com/api/v1/tools/striking_distance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"clientId":"string","days":28,"minPosition":4,"maxPosition":20,"minImpressions":50}),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "POST",
    "https://seolyticize.com/api/v1/tools/striking_distance",
    headers={
    "Content-Type": "application/json",
    },
    json={"clientId": "string", "days": 28, "minPosition": 4, "maxPosition": 20, "minImpressions": 50},
)
data = res.json()

package main

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

func main() {
	req, _ := http.NewRequest("POST", "https://seolyticize.com/api/v1/tools/striking_distance", strings.NewReader(`{"clientId":"string","days":28,"minPosition":4,"maxPosition":20,"minImpressions":50}`))
	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/striking_distance');
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","days":28,"minPosition":4,"maxPosition":20,"minImpressions":50}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://seolyticize.com/api/v1/tools/striking_distance')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"clientId":"string","days":28,"minPosition":4,"maxPosition":20,"minImpressions":50}'
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/striking_distance"))
    .header("Content-Type", "application/json")
    .method("POST", BodyPublishers.ofString("{\"clientId\":\"string\",\"days\":28,\"minPosition\":4,\"maxPosition\":20,\"minImpressions\":50}"))
    .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