API Documentation

Internal API access for automation, CLI workflows, and agent tooling.

Overview

Service account tokens can access all routes.

Base URL

https://hgseocommander.com

Authentication

Authorization: Bearer sk_live_...

Create a key (CLI)

npm run cli -- admin create-key --name "Automation" --scopes read,write

Fetch the merged OpenAPI spec

curl -H "Authorization: Bearer sk_live_..." https://hgseocommander.com/api/docs/openapi?name=all

Downloads

OpenAPI specs and route index.

OpenAPI (All Routes)OpenAPI (V1)OpenAPI (Google)OpenAPI (SERP)Route Index

GBP Location Management

Manage location details, services, hours, and categories.

Endpoints

GET /api/google/business-profile/locations/{locationId}PATCH /api/google/business-profile/locations/{locationId}GET /api/google/business-profile/locations/{locationId}/servicesPUT /api/google/business-profile/locations/{locationId}/servicesGET /api/google/business-profile/categories?query=...GET /api/google/business-profile/categories/services?categoryId=...

Example: Update hours

PATCH /api/google/business-profile/locations/{locationId}
{
  "regularHours": {
    "periods": [
      {
        "openDay": "MONDAY",
        "openTime": { "hours": 9, "minutes": 0 },
        "closeDay": "MONDAY",
        "closeTime": { "hours": 17, "minutes": 0 }
      }
    ]
  }
}

Example: Replace services

PUT /api/google/business-profile/locations/{locationId}/services
{
  "services": [
    { "structuredServiceItem": { "serviceTypeId": "gcid:roofing_contractor" } },
    { "freeFormServiceItem": { "category": "gcid:roofing_contractor", "label": { "displayName": "Storm repair" } } }
  ]
}

View GBP schema details in OpenAPI

Route Explorer

Search across every API route in the system.

Loading routes…

MethodPathSource