Introduction — GEOCitation API Docs

Introduction

The GEOCitation API lets you programmatically launch AEO/GEO semantic audits and retrieve structured competitive intelligence data for Market and Gap analysis.

What is the GEOCitation API?

GEOCitation gives you API-first access to engineer your digital authority. Launch Market Intelligence audits to map competitive landscapes, or Gap Analysis audits to pinpoint specific content deficiencies. Receive webhook notifications on completion, and integrate citation intelligence directly into your n8n workflows, agents, or custom tools.

Key Capability

A single POST request launches a full AEO/GEO audit — our pipeline processes web signals through a 9-phase engine and returns structured, machine-readable data.

Asynchronous by Design

Submit a request and receive a 202 immediately. Get notified via webhook when your audit completes (typically 5-7 minutes).

HMAC-Signed Webhooks

Every webhook payload is signed with HMAC-SHA256 so you can verify it came from GEOCitation.

Quick Example

Launch a Market Intelligence audit for a keyword in France and retrieve the result.

bash

curl -X POST https://api.geocitation.io/v1/audits \
  -H "Content-Type: application/json" \
  -H "X-API-Key: geo_citation_YOUR_KEY" \
  -d '{
    "audit_type": "market",
    "keyword": "agence seo paris",
    "language": "fr",
    "country": "FR"
  }'

json

{
  "audit_id": "3227a3e3-...",
  "status": "pending",
  "created_at": "2026-07-11T14:32:00Z"
}

Key Concepts