Technische GEO-Berichte

Starten Sie die technische GEO-Analyse für eine URL. Anschließend können Sie die einzelnen Berichte auflisten, regelmäßig abfragen und abrufen. Die Berichte werden asynchron erstellt. Agent-Readiness, manchmal auch KI-Readiness genannt, nutzt report_type=agent_readiness.

GET`/technical_geo_reports`

Listet die technischen GEO-Berichte eines Typs für ein Projekt auf, die neuesten zuerst. Mit diesem Endpunkt ermitteln Sie Berichts-IDs und Status, bevor Sie ein vollständiges Ergebnis abrufen.

Parameter:

project_iderforderlich
report_typeerforderlich: crawlability, schema, content_readiness, discoverability, site_structure, robots_txt, agent_readiness, llms_txt, ai_visibility
status
batch_id
page
per_pagemaximal 100

GET`/technical_geo_reports/:id`

Liefert den aktuellen Status eines Berichts. Solange der Bericht läuft, ist poll_after_seconds 15. Ein abgeschlossener Bericht enthält result_data, ein fehlgeschlagener Bericht error_message. Ein abgeschlossener llms.txt-Bericht liefert außerdem result_data.content_version, den Wert, den Sie bei einer Bearbeitung zurücksenden, und metadata.output_language_code. Wurden die Dateien in der App, über die API oder über MCP bearbeitet, kommen manually_edited_at und die generierten Originale hinzu. Ist output_language_code gleich null, behalten die llms.txt-Dateien die Sprache der Website bei.

Parameter: project_id (erforderlich), report_type (erforderlich) und die id des Berichts in der URL.

POST`/technical_geo_reports`

Startet die vollständige technische GEO-Analyse mit allen neun Berichten für eine URL und ein Land. Der Vorgang startet nur, wenn in Ihrem Tageskontingent noch mindestens neun Einheiten frei sind. Jeder erfolgreich erstellte Bericht verbraucht eine Einheit, ein nicht erstellter Bericht keine. Wie groß das Tageskontingent ist, hängt vom Konto ab. Jeder Bericht wird in einem Hintergrundprozess erstellt. Die Antwort enthält report_ids mit dem Berichtstyp als Schlüssel und weist den Client an, jede ID regelmäßig über den Endpunkt für die Berichtsdetails abzufragen. Erfordert einen API-Schlüssel mit dem Zugriffsumfang read_write.

Anfragetext (JSON):

project_iderforderlich
urlerforderlich
country_codeoptional, standardmäßig das Land des Projekts
output_language_codeoptional, Sprache nach ISO 639-1, in der die llms.txt-Dateien geschrieben werden, standardmäßig die Sprache des Projekts; auto behält die eigene Sprache der Website bei und wird als auto zurückgegeben; die übrigen Berichte der Analyse sind davon nicht betroffen

PATCH`/technical_geo_reports/:id/content`

Ersetzt die Dateien llms.txt und llms-full.txt eines abgeschlossenen llms.txt-Berichts, ohne den Bericht neu zu generieren. edits enthält den vollständigen neuen Text einer oder beider Dateien, und content_version muss dem Wert result_data.content_version aus der zuletzt abgerufenen Fassung des Berichts entsprechen. Hat sich der Bericht seitdem geändert, wird die Bearbeitung mit ERR_INVALID_PARAM abgelehnt: Rufen Sie den Bericht dann erneut ab und senden Sie die Änderung noch einmal. Eine Datei, deren Text dem gespeicherten entspricht, wird ignoriert, und bei der ersten Änderung werden die generierten Dateien gesichert, damit sie sich wiederherstellen lassen. changed_files listet die geänderten Dateien auf und ist leer, wenn sich nichts geändert hat.

Anfragetext (JSON): project_id (erforderlich), report_type (erforderlich, muss llms_txt sein), content_version (erforderlich, String), edits (erforderlich, Objekt mit llms_txt und/oder llms_full_txt, jeweils die vollständige neue Datei, nicht leer und höchstens 200.000 Zeichen) und die id des Berichts in der URL. Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Erstellen“ für GEO-Optimierung.

POST`/technical_geo_reports/:id/revert_content`

Verwirft alle manuellen Änderungen eines llms.txt-Berichts und stellt die generierten Dateien wieder her, die bei der ersten Änderung gesichert wurden. manually_edited_at, original_llms_txt_content und original_llms_full_txt_content werden wieder auf null gesetzt, und content_version ändert sich. Gibt ERR_INVALID_PARAM zurück, wenn der Bericht keine manuellen Änderungen enthält.

Anfragetext (JSON): project_id (erforderlich), report_type (erforderlich, muss llms_txt sein) und die id des Berichts in der URL. Erfordert einen API-Schlüssel mit Schreibzugriff und bei Teammitgliedern die Berechtigung „Erstellen“ für GEO-Optimierung.

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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","output_language_code":"en"}' \
  "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","output_language_code":"en"})
});
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", "output_language_code": "en"}
)
data = response.json()

require 'httparty'
require 'json'

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

package main

import (
	"net/http"
	"strings"
)

func main() {
	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","output_language_code":"en"}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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', 'output_language_code' => 'en']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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\",\"output_language_code\":\"en\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X PATCH -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","report_type":"llms_txt","content_version":"1790676600123456","edits":{"llms_txt":"# Acme\n\n\u003e Project management software for small teams.\n\n## Product\n\n- [Pricing](https://acme.com/pricing): Plans and prices\n"}}' \
  "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content"

const response = await fetch("https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","report_type":"llms_txt","content_version":"1790676600123456","edits":{"llms_txt":"# Acme\n\n\u003e Project management software for small teams.\n\n## Product\n\n- [Pricing](https://acme.com/pricing): Plans and prices\n"}})
});
const data = await response.json();

import requests

response = requests.patch(
    "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "report_type": "llms_txt", "content_version": "1790676600123456", "edits": {"llms_txt": "# Acme\n\n\u003e Project management software for small teams.\n\n## Product\n\n- [Pricing](https://acme.com/pricing): Plans and prices\n"}}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.patch(
  "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "report_type" => "llms_txt", "content_version" => "1790676600123456", "edits" => { "llms_txt" => "# Acme\n\n> Project management software for small teams.\n\n## Product\n\n- [Pricing](https://acme.com/pricing): Plans and prices\n" } }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("PATCH", "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content", strings.NewReader(`{"project_id":"PROJECT_ID","report_type":"llms_txt","content_version":"1790676600123456","edits":{"llms_txt":"# Acme\n\n\u003e Project management software for small teams.\n\n## Product\n\n- [Pricing](https://acme.com/pricing): Plans and prices\n"}}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('PATCH', 'https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'report_type' => 'llms_txt', 'content_version' => '1790676600123456', 'edits' => ['llms_txt' => '# Acme

> Project management software for small teams.

## Product

- [Pricing](https://acme.com/pricing): Plans and prices
']]
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/technical_geo_reports/205/content"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"report_type\":\"llms_txt\",\"content_version\":\"1790676600123456\",\"edits\":{\"llms_txt\":\"# Acme\\n\\n\\u003e Project management software for small teams.\\n\\n## Product\\n\\n- [Pricing](https://acme.com/pricing): Plans and prices\\n\"}}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": 205,
  "report_type": "llms_txt",
  "project_id": 123,
  "batch_id": 42,
  "domain": "acme.com",
  "output_language_code": "en",
  "status": "completed",
  "result_available": true,
  "updated_at": "2026-09-29T10:15:00Z",
  "result_data": {
    "llms_txt_content": "# Acme\n\n> Project management software for small teams.\n...",
    "llms_full_txt_content": "# Acme\n\n...",
    "manually_edited_at": "2026-09-29T10:15:00Z",
    "content_version": "1790676900",
    "original_llms_txt_content": "# Acme\n\n> Acme builds project management software.\n...",
    "original_llms_full_txt_content": "# Acme\n\n...",
    "metadata": { "output_language_code": "en", "...": "..." },
    "pages_crawled": 24
  },
  "error_message": null,
  "poll_after_seconds": null,
  "changed_files": ["llms_txt"],
  "request_id": "..."
}

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","report_type":"llms_txt"}' \
  "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content"

const response = await fetch("https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","report_type":"llms_txt"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "report_type": "llms_txt"}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "report_type" => "llms_txt" }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content", strings.NewReader(`{"project_id":"PROJECT_ID","report_type":"llms_txt"}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'report_type' => 'llms_txt']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/technical_geo_reports/205/revert_content"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"report_type\":\"llms_txt\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": 205,
  "report_type": "llms_txt",
  "project_id": 123,
  "batch_id": 42,
  "domain": "acme.com",
  "output_language_code": "en",
  "status": "completed",
  "result_available": true,
  "updated_at": "2026-09-29T10:20:00Z",
  "result_data": {
    "llms_txt_content": "# Acme\n\n> Acme builds project management software.\n...",
    "llms_full_txt_content": "# Acme\n\n...",
    "manually_edited_at": null,
    "content_version": "1790677200",
    "original_llms_txt_content": null,
    "original_llms_full_txt_content": null,
    "metadata": { "output_language_code": "en", "...": "..." },
    "pages_crawled": 24
  },
  "error_message": null,
  "poll_after_seconds": null,
  "request_id": "..."
}

Technische GEO-Berichte

GET/technical_geo_reports

GET/technical_geo_reports/:id

POST/technical_geo_reports

PATCH/technical_geo_reports/:id/content

POST/technical_geo_reports/:id/revert_content

GET`/technical_geo_reports`

GET`/technical_geo_reports/:id`

POST`/technical_geo_reports`

PATCH`/technical_geo_reports/:id/content`

POST`/technical_geo_reports/:id/revert_content`