Public API: Advanced Ranking

import os
import requests

API_KEY = os.environ["KWI_API_KEY"]
BASE_URL = "https://api.keywordinsights.ai"
HEADERS = {"X-API-Key": API_KEY}

payload = {
    "keyword": "project management software",
    "domain": "asana.com",
    "language": "en",
    "location": "United States",
}

response = requests.post(
    f"{BASE_URL}/api/advanced-ranking/order/",
    headers=HEADERS,
    json=payload,
)

data = response.json()
print(data)
# {"status": true, "order_id": "2879fa0b-...", "cost": 1}

payload = {
    "keyword": "best CRM software",
    "domain": "hubspot.com",
    "language": "en",
    "location": "United States",
    "include_word_count": True,  # 10 credits instead of 1
}

payload = {
    "keywords": [
        "project management software",
        "best project management tools",
        "project management for teams",
    ],
    "domain": "asana.com",
    "language": "en",
    "location": "United States",
}

response = requests.post(
    f"{BASE_URL}/api/advanced-ranking/batch/order/",
    headers=HEADERS,
    json=payload,
)

data = response.json()
print(f"Batch order: {data['order_id']} (cost: {data['cost']} credits)")

import os
import time
import requests

API_KEY = os.environ["KWI_API_KEY"]
BASE_URL = "https://api.keywordinsights.ai"
HEADERS = {"X-API-Key": API_KEY}

order_id = "2879fa0b-deae-4aab-ad87-fd8fb8db9717"

while True:
    response = requests.get(
        f"{BASE_URL}/api/advanced-ranking/order/",
        headers=HEADERS,
        params={"order_id": order_id},
    )

    data = response.json()["result"]["payload"]

    if data["status"] == "done":
        break

    print("Processing...")
    time.sleep(10)

results = data["results"]
print(f"Domain URLs in top 100: {results['n_domain_rankings']}")

for ranking in results["domain_rankings"]:
    print(f"  #{ranking['rank']} — {ranking['url']}")

print(f"\nTop 10 SERP results:")
for url_data in results["top_rankings"]:
    wc = f" ({url_data['word_count']} words)" if url_data.get("word_count") else ""
    print(f"  {url_data['url']}{wc}")

print(f"\nRelated searches: {results['related_searches']}")
print(f"People Also Ask: {results['related_questions']}")

import os
import time
import requests

API_KEY = os.environ["KWI_API_KEY"]
BASE_URL = "https://api.keywordinsights.ai"
HEADERS = {"X-API-Key": API_KEY}


def create_batch(keywords, domain, language="en", location="United States"):
    """Create a batch ranking order."""
    response = requests.post(
        f"{BASE_URL}/api/advanced-ranking/batch/order/",
        headers=HEADERS,
        json={
            "keywords": keywords,
            "domain": domain,
            "language": language,
            "location": location,
            "include_word_count": True,
        },
    )
    response.raise_for_status()
    return response.json()


def wait_for_batch(order_id):
    """Poll until batch is complete."""
    while True:
        response = requests.get(
            f"{BASE_URL}/api/advanced-ranking/batch/order/",
            headers=HEADERS,
            params={"order_id": order_id},
        )
        data = response.json()["result"]["payload"]

        if data["status"] == "done":
            return data["results"]

        print("Processing...")
        time.sleep(15)


# --- Run ---

keywords = [
    "project management software",
    "task management tool",
    "team collaboration software",
]

result = create_batch(keywords, domain="asana.com")
order_id = result["order_id"]
print(f"Batch created: {order_id} (cost: {result['cost']} credits)")

results = wait_for_batch(order_id)

for item in results:
    print(f"\n'{item['keyword']}': {item['n_domain_rankings']} URLs in top 100")
    for r in item["domain_rankings"][:3]:
        print(f"  #{r['rank']} — {r['url']}")