Developers

SERPHub REST API

35+ endpoints. JSON responses. Sanctum token auth. Pull your SEO data into any tool, dashboard, or workflow.

Quick Start

Generate a Sanctum API token from your account settings, then include it as a Bearer token on every request.

1 Log in → Account Settings → Security → API Tokens → Generate token
2 Include the token as Authorization: Bearer YOUR_TOKEN on each request
3 Base URL: https://serphub.io/api/v1

curl

curl https://serphub.io/api/v1/sites \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Response (200)

{
  "data": [
    {
      "id": 42,
      "domain": "example.com",
      "health_score": 91,
      "last_audit_at": "2026-05-20T08:15:00Z"
    }
  ]
}

API Reference

All endpoints return JSON. All write operations require a POST body as JSON with Content-Type: application/json.

Sites

GET /sites List all sites

GET /sites/{id} Get site details

POST /sites Create a site

DELETE /sites/{id} Delete a site

Audits

GET /sites/{id}/audits List audits for a site

GET /sites/{id}/audits/latest Get latest audit

POST /sites/{id}/audits Trigger a new audit

GET /sites/{id}/issues Get open SEO issues

Keywords

GET /sites/{id}/keywords Get GSC keyword rankings

GET /sites/{id}/keywords/top Top keywords by clicks

GET /sites/{id}/cannibalization Keyword cannibalization

GET /sites/{id}/search-intent Search intent breakdown

Backlinks

GET /sites/{id}/backlinks List referring pages

POST /sites/{id}/backlinks/verify Trigger backlink verification

GET /sites/{id}/backlinks/stats Backlink statistics

AI Mentions

GET /sites/{id}/ai-mentions List AI brand mentions

GET /sites/{id}/ai-mentions/sov Share of Voice data

POST /sites/{id}/ai-mentions/run Trigger AI Mentions check

Competitors

GET /sites/{id}/competitors List competitors

POST /sites/{id}/competitors Add competitor

DELETE /sites/{id}/competitors/{competitorId} Remove competitor

Authentication & Rate Limits

Bearer Token (Sanctum)

All API requests must include a valid Sanctum personal access token. Generate tokens in Account → Security → API Tokens. Tokens do not expire but can be revoked at any time.

Rate Limits

API access is available on the Agency and Enterprise plans.

Plan	Requests/min	Requests/day
Agency	120	50,000
Enterprise	Custom	Custom

Error Responses

The API uses standard HTTP status codes. Error responses include a JSON body with a message field. 401 = invalid token, 403 = forbidden, 422 = validation error, 429 = rate limit exceeded.

Error Example

HTTP/1.1 422
{
  "message": "Validation error",
  "errors": {
    "domain": [
      "The domain field is required."
    ]
  }
}

Ready to integrate?

API access is available on the Agency and Enterprise plans. Sign up to get started.

Get Started Enterprise Inquiry