Developer API Reference

Learn how to query bot request logs and update organization entity schemas on your client WordPress nodes.

Authentication

All external API requests to client WordPress sites must authenticate by passing the secure connection token inside the X-GEO-API-Key HTTP request header.

GET /wp-json/geo-pro/v1/analytics/logs
Headers:
X-GEO-API-Key: GEO-PRO-YOUR-SECRET-TOKEN

Retrieve Analytics Logs

Fetches a paginated list of crawler activity entries logged from the database table. Requires a premium license configured.

HTTP Request

GET /wp-json/geo-pro/v1/analytics/logs

Response Example (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "14",
      "timestamp": "2026-07-12 20:54:09",
      "request_uri": "/hello-world/",
      "user_agent": "Mozilla/5.0... GPTBot/1.0",
      "ai_bot_detected": "OpenAI GPTBot",
      "geo_score": 88
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total_items": 3,
    "total_pages": 1
  }
}

Update Global Organization Schema

Overwrites the site-wide JSON-LD Organization schema attributes inside the database settings. These parameters are injected dynamically into singular pages when crawled by AI bot sniffers.

HTTP Request

PUT /wp-json/geo-pro/v1/schema/global

JSON Payload Structure

{
  "org_name": "GEO Pro Agency",
  "logo_url": "https://example.com/logo.png",
  "same_as": [
    "https://twitter.com/geoproagency",
    "https://github.com/geoproagency"
  ]
}

Response Example (200 OK)

{
  "success": true,
  "message": "Global schema updated successfully."
}