What ranking first for a keyword is worth

Embed

<a href="https://seolyticize.com/docs/ref-keyword-traffic-potential"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/2f89064e-ae9b-4f83-a23f-9eae2b2e3172/social-card.svg?v=3e7ae33eec8b" alt="What ranking first for a keyword is worth" width="600" height="315"></a>

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

Traffic potential and parent topic for a keyword: the estimated monthly organic traffic of the page ranking first, summed across every keyword that page ranks for, and that page's highest-volume keyword. Answers 'how much traffic is this keyword really worth' and 'what topic should the page be about' — a keyword's own volume undersells it. Estimated through the measured click curve and labelled with its source. Null when the leader's rankings are unknown, never zero. May buy the results page and the leader's ranked keywords when the archive holds neither.

Request body application/json

clientIdstringrequired

termstringrequired

locationCodeinteger

= 2840

languageCodestring

= en

refreshboolean

= false

maxCostMicrosinteger

Optional spending limit for this call, in micro-USD (1,000,000 = $1). A purchase that would take the call past it is refused before anything is bought. Pass the estimate from estimate_cost, or what the user agreed to spend.

{
  "clientId": "string",
  "term": "string",
  "locationCode": 2840,
  "languageCode": "en",
  "refresh": false,
  "maxCostMicros": 0
}

Code samples

cURL

curl -X POST "https://seolyticize.com/api/v1/tools/keyword_traffic_potential" \
  -H "Content-Type: application/json" \
  -d '{"clientId":"string","term":"string","locationCode":2840,"languageCode":"en","refresh":false,"maxCostMicros":0}'

TypeScript

const res = await fetch('https://seolyticize.com/api/v1/tools/keyword_traffic_potential', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"clientId":"string","term":"string","locationCode":2840,"languageCode":"en","refresh":false,"maxCostMicros":0}),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "POST",
    "https://seolyticize.com/api/v1/tools/keyword_traffic_potential",
    headers={
    "Content-Type": "application/json",
    },
    json={"clientId": "string", "term": "string", "locationCode": 2840, "languageCode": "en", "refresh": False, "maxCostMicros": 0},
)
data = res.json()

package main

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

func main() {
	req, _ := http.NewRequest("POST", "https://seolyticize.com/api/v1/tools/keyword_traffic_potential", strings.NewReader(`{"clientId":"string","term":"string","locationCode":2840,"languageCode":"en","refresh":false,"maxCostMicros":0}`))
	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/keyword_traffic_potential');
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","term":"string","locationCode":2840,"languageCode":"en","refresh":false,"maxCostMicros":0}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://seolyticize.com/api/v1/tools/keyword_traffic_potential')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"clientId":"string","term":"string","locationCode":2840,"languageCode":"en","refresh":false,"maxCostMicros":0}'
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/keyword_traffic_potential"))
    .header("Content-Type", "application/json")
    .method("POST", BodyPublishers.ofString("{\"clientId\":\"string\",\"term\":\"string\",\"locationCode\":2840,\"languageCode\":\"en\",\"refresh\":false,\"maxCostMicros\":0}"))
    .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