Technical GEO Reports

Launch the Technical GEO bundle for a URL, then list, poll and retrieve each report. Reports run asynchronously. Agent Readiness, sometimes called AI readiness, uses report_type=agent_readiness.

GET`/technical_geo_reports`

List one Technical GEO report type for a project, newest first. Use this endpoint to find report ids and status before retrieving a full result.

Params:

project_idrequired
report_typerequired: crawlability, schema, content_readiness, discoverability, site_structure, robots_txt, agent_readiness, llms_txt, ai_visibility
status
batch_id
page
per_pagemaximum 100

GET`/technical_geo_reports/:id`

Get one report's current status. While it is running, poll_after_seconds is 15. A completed report includes result_data; a failed report includes error_message.

Params: project_id (required), report_type (required), and the report id in the URL.

POST`/technical_geo_reports`

Launch the full Technical GEO analysis bundle for a URL and country. Each report runs as a background job. The response includes report_ids, keyed by report type, and tells the client to poll each id through the report detail endpoint.

Body (JSON):

project_idrequired
urlrequired
country_codeoptional, defaults to the project country

Code Examples

Download: OpenAPI Swagger Postman

Ask AI: Open in ChatGPT Open in Claude View as Markdown

Language

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed"

const response = await fetch("https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/technical_geo_reports?project_id=PROJECT_ID&report_type=agent_readiness&status=completed"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "project_id": 123,
  "report_type": "agent_readiness",
  "page": 1,
  "per_page": 20,
  "total": 1,
  "data": [{
    "id": 101,
    "report_type": "agent_readiness",
    "batch_id": 42,
    "domain": "acme.com",
    "status": "completed",
    "result_available": true,
    "overall_score": 62,
    "created_at": "2026-08-21T09:00:00Z"
  }],
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness"

const response = await fetch("https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/technical_geo_reports/101?project_id=PROJECT_ID&report_type=agent_readiness"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "id": 101,
  "report_type": "agent_readiness",
  "project_id": 123,
  "batch_id": 42,
  "domain": "acme.com",
  "status": "completed",
  "result_available": true,
  "overall_score": 62,
  "result_data": {
    "overall_score": 62,
    "grade": "C",
    "dimension_scores": { "...": "..." },
    "checks": [],
    "recommendations": []
  },
  "error_message": null,
  "poll_after_seconds": null,
  "request_id": "..."
}

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","url":"https://acme.com/pricing","country_code":"US"}' \
  "https://api.llmpulse.ai/api/v1/technical_geo_reports"

const response = await fetch("https://api.llmpulse.ai/api/v1/technical_geo_reports", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","url":"https://acme.com/pricing","country_code":"US"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/technical_geo_reports",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","url":"https://acme.com/pricing","country_code":"US"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/technical_geo_reports",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","url":"https://acme.com/pricing","country_code":"US"}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/technical_geo_reports", strings.NewReader(`{"project_id":"PROJECT_ID","url":"https://acme.com/pricing","country_code":"US"}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/technical_geo_reports', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","url":"https://acme.com/pricing","country_code":"US"}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/technical_geo_reports"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"url\":\"https://acme.com/pricing\",\"country_code\":\"US\"}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());