API Reference

Use SEO Boost Hub endpoints to manage locations, keywords, content, and insight data with consistent REST conventions.

Base URL https://seoboosthub.com/api/v1

Locations

GET /api/v1/locations List all locations in your organization

GET /api/v1/locations/{id} Retrieve details for a specific location

POST /api/v1/locations Register a new business location

PATCH /api/v1/locations/{id} Update location details

Keywords

GET /api/v1/locations/{id}/keywords List all tracked keywords for a location

POST /api/v1/locations/{id}/keywords Add a keyword to track for a location

DELETE /api/v1/keywords/{id} Remove a tracked keyword

Rank Scans

GET /api/v1/keywords/{id}/scans Retrieve rank scan history for a keyword

Content Posts

GET /api/v1/locations/{id}/posts List all content posts for a location

POST /api/v1/locations/{id}/posts Create a new content post for a location

Insights

GET /api/v1/locations/{id}/insights Retrieve weekly insight metrics for a location

Example

Below is an example request and response for listing locations.

Example Request

curl -X GET https://seoboosthub.com/api/v1/locations \
  -H "Authorization: Bearer sbh_live_abc123def456ghi789" \
  -H "Accept: application/json"

Example Response 200 OK

{
  "data": [
    {
      "id": "loc_01hx7a9b2c",
      "name": "Downtown Coffee Shop",
      "address": "123 Main St, Berlin",
      "city": "Berlin",
      "country": "DE",
      "rank_score": 72,
      "status": "active",
      "keywords_count": 12,
      "last_scan_at": "2025-11-28T08:00:00Z",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 1
  }
}