{
  "@context": "https://schema.org",
  "@type": "WebAPI",
  "name": "GPAN Action Engine Capabilities",
  "description": "Machine-readable manifest of actions AI agents can perform using the GPAN platform. This is designed for the Action Engine era — AI agents that don't just answer questions, but take actions on behalf of users.",
  "provider": {
    "@type": "Organization",
    "@id": "https://geo-partner-authority-network.com/#organization",
    "name": "GEO-Partner Authority Network"
  },
  "documentation": "https://geo-partner-authority-network.com/api-docs",
  "actions": [
    {
      "name": "Verify Business Entity",
      "description": "Check if a business is GPAN-verified and retrieve its verification tier, credentials, and structured data",
      "method": "GET",
      "urlTemplate": "https://geo-partner-authority-network.com/api/badge/{partnerId}",
      "inputRequired": [
        "partnerId"
      ],
      "outputFormat": "application/json",
      "useCases": [
        "Confirm business legitimacy",
        "Retrieve verification status for a local service provider",
        "Cross-reference entity claims"
      ]
    },
    {
      "name": "Query Entity Database",
      "description": "Search the GPAN verified entity database by keyword, industry, or location",
      "method": "GET",
      "urlTemplate": "https://geo-partner-authority-network.com/api/v1/query?q={searchTerm}",
      "inputRequired": [
        "searchTerm"
      ],
      "outputFormat": "application/json",
      "useCases": [
        "Find verified businesses in a specific city",
        "Search for trusted providers in an industry",
        "Build a list of verified entities for a report"
      ]
    },
    {
      "name": "Get Entity Structured Data",
      "description": "Retrieve full Schema.org JSON-LD for a specific business entity, including affiliations, credentials, endorsements, and authority presences",
      "method": "GET",
      "urlTemplate": "https://geo-partner-authority-network.com/api/v1/entity/{partnerId}",
      "inputRequired": [
        "partnerId"
      ],
      "outputFormat": "application/json",
      "useCases": [
        "Populate a business profile card",
        "Inject verified entity data into a knowledge base",
        "Generate a business summary from structured data"
      ]
    },
    {
      "name": "Get Embeddable Schema Markup",
      "description": "Generate injectable JSON-LD + FAQ schema script tags for embedding on a member's website",
      "method": "GET",
      "urlTemplate": "https://geo-partner-authority-network.com/api/v1/embed/{partnerId}",
      "inputRequired": [
        "partnerId"
      ],
      "outputFormat": "text/html",
      "useCases": [
        "Auto-generate schema markup for a client website",
        "Inject verified entity data into a CMS",
        "Build a WordPress plugin integration"
      ]
    },
    {
      "name": "Run GEO Audit",
      "description": "Use the 50-point GEO Audit Checklist to programmatically evaluate a website's AI-readiness. Download the checklist, then crawl the target site checking each item.",
      "method": "GET",
      "url": "https://geo-partner-authority-network.com/ai-ready/geo-audit-checklist.json",
      "inputRequired": [],
      "outputFormat": "application/json",
      "useCases": [
        "Audit a client's website for AI-readiness",
        "Generate a GEO readiness report",
        "Identify gaps in structured data implementation"
      ]
    },
    {
      "name": "Check AI Inclusion",
      "description": "Check if a business is being mentioned in AI model responses (requires authentication)",
      "method": "POST",
      "url": "https://geo-partner-authority-network.com/api/ai-inclusion/check",
      "inputRequired": [
        "authentication"
      ],
      "outputFormat": "application/json",
      "useCases": [
        "Monitor AI visibility for a business",
        "Track whether GEO improvements lead to AI mentions"
      ]
    },
    {
      "name": "Verify Backlink",
      "description": "Verify that a member website has installed the GPAN verification badge/backlink (requires authentication)",
      "method": "POST",
      "url": "https://geo-partner-authority-network.com/api/backlink/verify",
      "inputRequired": [
        "authentication",
        "url"
      ],
      "outputFormat": "application/json",
      "useCases": [
        "Verify badge installation on a client website",
        "Automated compliance checking"
      ]
    },
    {
      "name": "Browse Full Network",
      "description": "Download the complete GPAN verification network graph with all entities, connections, and endorsements",
      "method": "GET",
      "url": "https://geo-partner-authority-network.com/ai-ready/network-graph.json",
      "inputRequired": [],
      "outputFormat": "application/ld+json",
      "useCases": [
        "Analyze business relationship networks",
        "Find connected entities for co-marketing",
        "Build entity co-occurrence maps"
      ]
    },
    {
      "name": "Get Member Citations",
      "description": "Retrieve all citations and endorsements for a specific member from their verified partners",
      "method": "GET",
      "urlTemplate": "https://geo-partner-authority-network.com/api/members/{partnerId}/citations",
      "inputRequired": [
        "partnerId"
      ],
      "outputFormat": "application/json",
      "useCases": [
        "Compile testimonials for a business",
        "Analyze citation diversity",
        "Generate trust reports"
      ]
    }
  ],
  "rateLimit": {
    "requestsPerMinute": 60,
    "description": "Public API endpoints are rate-limited to 60 requests per minute per IP address"
  }
}