SEO workflows for AI agents. Built for human experts.

pip install httpx

import httpx
import time

API_BASE = "https://api.searchflow.app"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
  "keywords": [
    {
      "keyword": "agence seo",
      "volume": 1000
    },
    {
      "keyword": "agence seo paris",
      "volume": 900
    },
    {
      "keyword": "agence seo toulouse",
      "volume": 800
    },
    {
      "keyword": "agence seo paris prix",
      "volume": 700
    },
    {
      "keyword": "création de site web",
      "volume": 2000
    },
    {
      "keyword": "création de site internet",
      "volume": 1900
    }
  ],
  "locale": {
    "country": "fr",
    "language": "fr"
  },
  "serp_similarity_threshold": 0.4,
  "thematic_clustering": {
    "enabled": true,
    "label_with_ai": true
  },
  "domain_tracking": {
    "enabled": false
  }
}

response = httpx.post(
    f"{API_BASE}/api/v1/workflows/keyword-clustering/runs",
    headers=HEADERS,
    json=payload,
    timeout=30.0,
)
response.raise_for_status()
run = response.json()

deadline = time.time() + 7200

while time.time() < deadline:
    status_response = httpx.get(
        f"{API_BASE}/api/v1/workflows/keyword-clustering/runs/{run['run_id']}",
        headers=HEADERS,
        timeout=30.0,
    )
    status_response.raise_for_status()
    status = status_response.json()
    if status["status"] in ("completed", "failed"):
        break
    time.sleep(2)
else:
    raise TimeoutError("Timed out while waiting for the keyword-clustering run")

for cluster in status["result"]["serp_clusters"]:
    print(cluster["centroid"], len(cluster["keywords"]))