GEO-Audits

Überwachen Sie eine Domain oder URL mit einer technischen GEO-Prüfung und verfolgen Sie die Entwicklung. Jedes Audit führt einen Audit-Typ einmalig, wöchentlich oder monatlich aus, speichert jeden Durchlauf mit Score, Prüfergebnissen und Problemen, vergleicht zwei beliebige Durchläufe und löst Benachrichtigungen aus, wenn eine kritische Prüfung erstmals oder erneut fehlschlägt, wieder erfolgreich ist oder die Website nicht mehr antwortet. Wöchentliche und monatliche Durchläufe sind für agent_readiness und robots_txt verfügbar; die übrigen Typen werden einmalig ausgeführt und liefern nur einen Score. Manuelle Durchläufe sind auf 6 pro Audit in einem gleitenden Zeitfenster von einer Stunde sowie 200 pro Konto und Tag begrenzt, und für aktive wiederkehrende Audits gilt ein Tariflimit. Schreibanfragen erfordern einen API-Schlüssel mit dem Zugriffsumfang read_write und bei Teammitgliedern die entsprechende Berechtigung für GEO-Optimierung.

GET`/geo_audits`

Listet die Audits des Projekts auf, die zuletzt aktualisierten zuerst, jeweils mit dem letzten Durchlauf, der Anzahl offener Probleme und dem nächsten geplanten Durchlauf. Archivierte Audits sind nur mit status=archived enthalten. recurring_available gibt an, ob der Typ wöchentlich oder monatlich ausgeführt werden kann, und checks_tracked, ob seine Durchläufe Prüfergebnisse und Probleme oder nur einen Score liefern.

Parameter:

project_iderforderlich
audit_typeagent_readiness, robots_txt, crawlability, schema, content_readiness, discoverability, site_structure
statusactive, paused, archived
cadenceonce, weekly, monthly
page
per_pagemaximal 100

POST`/geo_audits`

Erstellt für eine Domain oder URL ein Audit pro Eintrag in audit_types. Jedes Audit startet sofort seinen ersten Durchlauf, und dieser wird auf die Limits für manuelle Durchläufe angerechnet. cadence mit dem Wert weekly oder monthly ist nur für agent_readiness und robots_txt zulässig; solche Audits werden auf das Tariflimit für aktive wiederkehrende Audits angerechnet (ERR_LIMIT_REACHED). Wird ein archiviertes Audit erneut erstellt, wird es mit seinem Verlauf wiederhergestellt. Erfordert einen API-Schlüssel mit dem Zugriffsumfang read_write.

Anfragetext (JSON):

project_iderforderlich
targeterforderlich, die Domain oder Seiten-URL
audit_typeserforderlich, Array: agent_readiness, robots_txt, crawlability, schema, content_readiness, discoverability, site_structure
cadenceoptional: once, weekly, monthly; standardmäßig once

GET`/geo_audits/:id`

Ein Audit mit Zeitplan, Status, letztem Durchlauf und der Anzahl offener Probleme. paused_reason ist user, unreachable, wenn drei Durchläufe in Folge die Website nicht erreichen konnten, oder quota, wenn das Konto mehr aktive wiederkehrende Audits hat, als sein Tarif erlaubt.

Parameter:

project_iderforderlich
idin der URL, die Audit-ID

PATCH`/geo_audits/:id`

Ändert den Rhythmus, den Tag und die Uhrzeit der geplanten Durchläufe, die E-Mail-Benachrichtigungen oder den Status eines Audits. Für status gilt: paused pausiert die geplanten Durchläufe, active setzt sie fort und archived entspricht DELETE. Wenn Sie ein Audit auf einen wiederkehrenden Rhythmus umstellen oder fortsetzen, wird es auf das Tariflimit für aktive wiederkehrende Audits angerechnet (ERR_LIMIT_REACHED). Erfordert einen API-Schlüssel mit dem Zugriffsumfang read_write und bei Teammitgliedern die Berechtigung „Aktualisieren“ für GEO-Optimierung.

Anfragetext (JSON):

project_iderforderlich
cadenceoptional: once, weekly, monthly
schedule_dayoptional: 0 für Sonntag bis 6 bei wöchentlichem, 1 bis 28 bei monatlichem Rhythmus
schedule_houroptional, 0 bis 23 in der Zeitzone des Audits
statusoptional: active, paused, archived
email_alertsoptional, boolescher Wert
idin der URL, die Audit-ID

DELETE`/geo_audits/:id`

Archiviert ein Audit. Es wird nicht mehr ausgeführt und aus der Liste entfernt (archivierte Audits listen Sie mit status=archived auf). Wenn Sie dasselbe Audit erneut erstellen, wird es mit seinem Verlauf wiederhergestellt. Erfordert einen API-Schlüssel mit dem Zugriffsumfang read_write und bei Teammitgliedern die Berechtigung „Löschen“ für GEO-Optimierung.

Parameter:

project_iderforderlich
idin der URL, die Audit-ID

GET`/geo_audits/:id/comparison`

Vergleicht zwei abgeschlossene Durchläufe eines Audits Prüfung für Prüfung. Standardmäßig wird der letzte abgeschlossene Durchlauf mit dem vorherigen verglichen. changes listet jede Prüfung und jedes Prüfobjekt mit dem jeweiligen Wert für change auf (new, fixed, changed, appeared, disappeared, unchanged), counts summiert sie, und score_delta sowie metric_deltas zeigen die Veränderung. comparable: false bedeutet, dass sich die Prüfungen oder die Einstellungen des Audits zwischen den beiden Durchläufen geändert haben. Hat das Audit noch keinen abgeschlossenen Durchlauf, wird ERR_NOT_FOUND zurückgegeben.

Parameter:

project_iderforderlich
from_runoptional, Durchlaufnummer
to_runoptional, Durchlaufnummer
idin der URL, die Audit-ID

GET`/geo_audits/:geo_audit_id/runs`

Die Durchläufe eines Audits, die neuesten zuerst, jeweils mit Score, Bewertung, Status, Auslöser (scheduled, manual, api, mcp) und der Anzahl neuer, behobener und erneut aufgetretener Probleme, die der Durchlauf festgestellt hat. Auch im flachen Format oder als CSV verfügbar.

Parameter:

project_iderforderlich
page
per_pagemaximal 100
outputoptional: flat, csv
geo_audit_idin der URL

POST`/geo_audits/:geo_audit_id/runs`

Startet einen manuellen Durchlauf und gibt ihn mit dem Status queued zurück. Fragen Sie den Durchlauf anschließend regelmäßig ab, bis sein Status completed, failed oder unreachable lautet. Erlaubt sind höchstens 6 manuelle Durchläufe pro Audit in einem gleitenden Zeitfenster von einer Stunde sowie 200 pro Konto und Tag (ERR_LIMIT_REACHED); geplante Durchläufe zählen nicht mit. Erfordert einen API-Schlüssel mit dem Zugriffsumfang read_write.

Parameter:

project_iderforderlich
geo_audit_idin der URL

GET`/geo_audits/:geo_audit_id/runs/:sequence`

Ein Durchlauf mit Score, metrics und dem vollständigen result_data, also dem Bericht des Durchlaufs im Format des technischen GEO-Berichts desselben Typs. result_data ist null, bis der Durchlauf abgeschlossen ist. Ist ein Durchlauf fehlgeschlagen oder konnte er die Website nicht erreichen, nennt error den Grund.

Parameter:

project_iderforderlich
geo_audit_idin der URL
sequencein der URL, die Durchlaufnummer

GET`/geo_audits/:geo_audit_id/runs/:sequence/findings`

Die Prüfergebnisse eines Durchlaufs, die schwerwiegendsten zuerst: eine Zeile pro Prüfung und Prüfobjekt (site für websiteweite Prüfungen, ein Bot für die Bot-Prüfungen der robots.txt), jeweils mit status (pass, warn, fail, info, not_applicable, unknown), severity und evidence. Nur Durchläufe vom Typ agent_readiness oder robots_txt liefern Prüfergebnisse. Auch im flachen Format oder als CSV verfügbar.

Parameter:

project_iderforderlich
page
per_pagemaximal 100
outputoptional: flat, csv
geo_audit_idin der URL
sequencein der URL, die Durchlaufnummer

GET`/geo_audits/:geo_audit_id/issues`

Die Probleme eines Audits über alle Durchläufe hinweg, die schwerwiegendsten zuerst. Ein Problem ist eine fehlschlagende Prüfung für ein Prüfobjekt, die von Durchlauf zu Durchlauf verfolgt wird: state ist open, fixed oder gone, badge gibt an, wie sich das Problem im letzten vergleichbaren Durchlauf verändert hat (new, persisting, regressed, fixed, gone), und accepted kennzeichnet bewusst akzeptierte Probleme.

Parameter:

project_iderforderlich
stateoptional: open, accepted, fixed, gone; open schließt akzeptierte Probleme aus; standardmäßig alle
page
per_pagemaximal 100
geo_audit_idin der URL

PATCH`/geo_audits/:geo_audit_id/issues/:id`

Akzeptiert ein Problem oder wertet es wieder als offen. Ein akzeptiertes Problem bleibt in der Liste, zählt aber nicht mehr zu den offenen Problemen; die Akzeptanz erlischt automatisch, sobald sich die Nachweise des Problems ändern. Erfordert einen API-Schlüssel mit dem Zugriffsumfang read_write und bei Teammitgliedern die Berechtigung „Aktualisieren“ für GEO-Optimierung.

Anfragetext (JSON):

project_iderforderlich
acceptederforderlich, true akzeptiert das Problem, false wertet es wieder als offen
geo_audit_idin der URL
idin der URL, die ID des Problems

GET`/geo_alerts`

Von den GEO-Audits des Projekts ausgelöste Benachrichtigungen, die neuesten zuerst. Jede Benachrichtigung gehört zu einem Durchlauf und listet ihre events auf: new_critical (eine kritische Prüfung schlägt jetzt fehl), regression (eine behobene Prüfung schlägt erneut fehl), recovered, score_drop, unreachable und paused (drei Durchläufe in Folge konnten die Website nicht erreichen). Jedes Ereignis enthält in message eine lesbare Meldung.

Parameter:

project_iderforderlich
audit_idoptional, nur Benachrichtigungen dieses Audits
page
per_pagemaximal 100

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/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active",
  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/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active", 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/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active', [
    '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/geo_audits?project_id=PROJECT_ID&audit_type=robots_txt&status=active"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "project_id": 123,
  "page": 1,
  "per_page": 20,
  "total": 1,
  "data": [{
    "id": "A1b2C3d4E5f6G7h8J9k0L1m2",
    "audit_type": "robots_txt",
    "target": "acme.com",
    "country_code": null,
    "cadence": "weekly",
    "status": "active",
    "paused_reason": null,
    "schedule": { "day": 1, "hour": 9, "timezone": "Europe/Madrid" },
    "next_run_at": "2026-10-12T07:00:00Z",
    "email_alerts": true,
    "recurring_available": true,
    "checks_tracked": true,
    "latest_run": {
      "sequence": 4,
      "status": "completed",
      "trigger": "scheduled",
      "score": 78.0,
      "grade": "C",
      "score_delta": -14.0,
      "comparable_to_previous": true,
      "new_issues": 1,
      "fixed_issues": 0,
      "regressed_issues": 0,
      "error": null,
      "engine_version": "1",
      "created_at": "2026-10-05T07:00:00Z",
      "finished_at": "2026-10-05T07:01:10Z",
      "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=123"
    },
    "open_issues": 1,
    "open_critical_issues": 1,
    "created_at": "2026-09-14T08:30:00Z",
    "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=123"
  }],
  "request_id": "..."
}

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","target":"acme.com","audit_types":["agent_readiness","robots_txt"],"cadence":"weekly"}' \
  "https://api.llmpulse.ai/api/v1/geo_audits"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","target":"acme.com","audit_types":["agent_readiness","robots_txt"],"cadence":"weekly"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/geo_audits",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "target": "acme.com", "audit_types": ["agent_readiness", "robots_txt"], "cadence": "weekly"}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/geo_audits",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "target" => "acme.com", "audit_types" => ["agent_readiness", "robots_txt"], "cadence" => "weekly" }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/geo_audits", strings.NewReader(`{"project_id":"PROJECT_ID","target":"acme.com","audit_types":["agent_readiness","robots_txt"],"cadence":"weekly"}`))
	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/geo_audits', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'target' => 'acme.com', 'audit_types' => ['agent_readiness', 'robots_txt'], 'cadence' => 'weekly']
]);
$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/geo_audits"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"target\":\"acme.com\",\"audit_types\":[\"agent_readiness\",\"robots_txt\"],\"cadence\":\"weekly\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "data": [{
    "id": "A1b2C3d4E5f6G7h8J9k0L1m2",
    "audit_type": "robots_txt",
    "target": "acme.com",
    "cadence": "weekly",
    "status": "active",
    "schedule": { "day": 1, "hour": 9, "timezone": "Europe/Madrid" },
    "next_run_at": "2026-10-12T07:00:00Z",
    "latest_run": { "sequence": 1, "status": "queued", "trigger": "api", "score": null, "...": "..." },
    "open_issues": 0,
    "...": "..."
  }],
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID"

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

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID",
  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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID", 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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": "A1b2C3d4E5f6G7h8J9k0L1m2",
  "audit_type": "robots_txt",
  "target": "acme.com",
  "country_code": null,
  "cadence": "weekly",
  "status": "active",
  "paused_reason": null,
  "schedule": { "day": 1, "hour": 9, "timezone": "Europe/Madrid" },
  "next_run_at": "2026-10-12T07:00:00Z",
  "email_alerts": true,
  "recurring_available": true,
  "checks_tracked": true,
  "latest_run": { "sequence": 4, "status": "completed", "score": 78.0, "...": "..." },
  "open_issues": 1,
  "open_critical_issues": 1,
  "created_at": "2026-09-14T08:30:00Z",
  "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=123",
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X PATCH -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","cadence":"weekly","schedule_day":1,"schedule_hour":9,"email_alerts":true}' \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","cadence":"weekly","schedule_day":1,"schedule_hour":9,"email_alerts":true})
});
const data = await response.json();

import requests

response = requests.patch(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "cadence": "weekly", "schedule_day": 1, "schedule_hour": 9, "email_alerts": True}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.patch(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "cadence" => "weekly", "schedule_day" => 1, "schedule_hour" => 9, "email_alerts" => true }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("PATCH", "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2", strings.NewReader(`{"project_id":"PROJECT_ID","cadence":"weekly","schedule_day":1,"schedule_hour":9,"email_alerts":true}`))
	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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'cadence' => 'weekly', 'schedule_day' => 1, 'schedule_hour' => 9, 'email_alerts' => true]
]);
$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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"cadence\":\"weekly\",\"schedule_day\":1,\"schedule_hour\":9,\"email_alerts\":true}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": "A1b2C3d4E5f6G7h8J9k0L1m2",
  "audit_type": "robots_txt",
  "target": "acme.com",
  "cadence": "weekly",
  "status": "active",
  "schedule": { "day": 1, "hour": 9, "timezone": "Europe/Madrid" },
  "next_run_at": "2026-10-12T07:00:00Z",
  "email_alerts": true,
  "...": "...",
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID", {
  method: "DELETE",
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.delete(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.delete(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("DELETE", "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID", 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('DELETE', 'https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .DELETE()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": "A1b2C3d4E5f6G7h8J9k0L1m2",
  "archived": true,
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4",
  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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4", 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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/comparison?project_id=PROJECT_ID&from_run=3&to_run=4"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "from_run": { "sequence": 3, "status": "completed", "score": 92.0, "...": "..." },
  "to_run": { "sequence": 4, "status": "completed", "score": 78.0, "...": "..." },
  "comparable": true,
  "score_delta": -14.0,
  "metric_deltas": { "bots.blocked": 1, "bots.allowed": -1 },
  "counts": { "new": 1, "unchanged": 11 },
  "changes": [{
    "check_key": "search_bot_access",
    "check_title": "AI search and assistant bot access",
    "subject_key": "oai_searchbot",
    "subject": "OAI-SearchBot",
    "severity": "critical",
    "from_status": "pass",
    "to_status": "fail",
    "change": "new"
  }],
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20",
  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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20", 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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID&per_page=20"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "project_id": 123,
  "page": 1,
  "per_page": 20,
  "total": 4,
  "data": [{
    "sequence": 4,
    "status": "completed",
    "trigger": "scheduled",
    "score": 78.0,
    "grade": "C",
    "score_delta": -14.0,
    "comparable_to_previous": true,
    "new_issues": 1,
    "fixed_issues": 0,
    "regressed_issues": 0,
    "error": null,
    "engine_version": "1",
    "created_at": "2026-10-05T07:00:00Z",
    "finished_at": "2026-10-05T07:01:10Z",
    "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=123"
  }],
  "request_id": "..."
}

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID", 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('POST', 'https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "sequence": 5,
  "status": "queued",
  "trigger": "api",
  "score": null,
  "grade": null,
  "score_delta": null,
  "comparable_to_previous": true,
  "new_issues": 0,
  "fixed_issues": 0,
  "regressed_issues": 0,
  "error": null,
  "engine_version": null,
  "created_at": "2026-10-07T10:00:00Z",
  "finished_at": null,
  "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/5?project_id=123",
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID",
  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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID", 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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "sequence": 4,
  "status": "completed",
  "trigger": "scheduled",
  "score": 78.0,
  "grade": "C",
  "score_delta": -14.0,
  "comparable_to_previous": true,
  "new_issues": 1,
  "fixed_issues": 0,
  "regressed_issues": 0,
  "error": null,
  "engine_version": "1",
  "created_at": "2026-10-05T07:00:00Z",
  "finished_at": "2026-10-05T07:01:10Z",
  "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=123",
  "metrics": { "bots.allowed": 11, "bots.partial": 0, "bots.blocked": 1 },
  "result_data": { "robots_txt_found": true, "bots": [], "...": "..." },
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID",
  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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID", 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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4/findings?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "project_id": 123,
  "page": 1,
  "per_page": 20,
  "total": 12,
  "data": [{
    "check_key": "search_bot_access",
    "check_title": "AI search and assistant bot access",
    "subject_key": "oai_searchbot",
    "subject": "OAI-SearchBot",
    "status": "fail",
    "severity": "critical",
    "evidence": { "bot": "OAI-SearchBot", "blocked_paths": ["/"] }
  }],
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open",
  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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open", 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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open', [
    '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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues?project_id=PROJECT_ID&state=open"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "project_id": 123,
  "page": 1,
  "per_page": 20,
  "total": 1,
  "data": [{
    "id": 57,
    "check_key": "search_bot_access",
    "check_title": "AI search and assistant bot access",
    "subject_key": "oai_searchbot",
    "subject": "OAI-SearchBot",
    "severity": "critical",
    "state": "open",
    "badge": "new",
    "accepted": false,
    "accepted_at": null,
    "regression_count": 0,
    "evidence": { "bot": "OAI-SearchBot", "blocked_paths": ["/"] },
    "updated_at": "2026-10-05T09:04:00Z"
  }],
  "request_id": "..."
}

Request

curl -X PATCH -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","accepted":true}' \
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57"

const response = await fetch("https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","accepted":true})
});
const data = await response.json();

import requests

response = requests.patch(
    "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "accepted": True}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.patch(
  "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "accepted" => true }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("PATCH", "https://api.llmpulse.ai/api/v1/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57", strings.NewReader(`{"project_id":"PROJECT_ID","accepted":true}`))
	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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'accepted' => true]
]);
$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/geo_audits/A1b2C3d4E5f6G7h8J9k0L1m2/issues/57"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"accepted\":true}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "id": 57,
  "check_key": "search_bot_access",
  "check_title": "AI search and assistant bot access",
  "subject_key": "oai_searchbot",
  "subject": "OAI-SearchBot",
  "severity": "critical",
  "state": "open",
  "badge": "persisting",
  "accepted": true,
  "accepted_at": "2026-10-07T10:00:00Z",
  "regression_count": 0,
  "evidence": { "bot": "OAI-SearchBot", "blocked_paths": ["/"] },
  "updated_at": "2026-10-07T10:00:00Z",
  "project_id": 123,
  "request_id": "..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/geo_alerts?project_id=PROJECT_ID"

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

import requests

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

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/geo_alerts?project_id=PROJECT_ID",
  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/geo_alerts?project_id=PROJECT_ID", 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/geo_alerts?project_id=PROJECT_ID', [
    '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/geo_alerts?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{
  "project_id": 123,
  "page": 1,
  "per_page": 20,
  "total": 1,
  "data": [{
    "id": 31,
    "audit_id": "A1b2C3d4E5f6G7h8J9k0L1m2",
    "audit_type": "robots_txt",
    "target": "acme.com",
    "run_sequence": 4,
    "severity": "critical",
    "events": [{
      "kind": "new_critical",
      "check_key": "search_bot_access",
      "subject_key": "oai_searchbot",
      "severity": "critical",
      "message": "AI search and assistant bot access now fails for OAI-SearchBot on acme.com."
    }],
    "created_at": "2026-10-05T09:04:00Z",
    "app_url": "https://app.example.com/app/tools/geo-optimization/audits/A1b2C3d4E5f6G7h8J9k0L1m2/runs/4?project_id=123"
  }],
  "request_id": "..."
}

GEO-Audits

GET/geo_audits

POST/geo_audits

GET/geo_audits/:id

PATCH/geo_audits/:id

DELETE/geo_audits/:id

GET/geo_audits/:id/comparison

GET/geo_audits/:geo_audit_id/runs

POST/geo_audits/:geo_audit_id/runs

GET/geo_audits/:geo_audit_id/runs/:sequence

GET/geo_audits/:geo_audit_id/runs/:sequence/findings

GET/geo_audits/:geo_audit_id/issues

PATCH/geo_audits/:geo_audit_id/issues/:id

GET/geo_alerts

GET`/geo_audits`

POST`/geo_audits`

GET`/geo_audits/:id`

PATCH`/geo_audits/:id`

DELETE`/geo_audits/:id`

GET`/geo_audits/:id/comparison`

GET`/geo_audits/:geo_audit_id/runs`

POST`/geo_audits/:geo_audit_id/runs`

GET`/geo_audits/:geo_audit_id/runs/:sequence`

GET`/geo_audits/:geo_audit_id/runs/:sequence/findings`

GET`/geo_audits/:geo_audit_id/issues`

PATCH`/geo_audits/:geo_audit_id/issues/:id`

GET`/geo_alerts`