List surfaces

GET /v1/surfaces returns the live capability matrix: every surface and whether it’s requestable today. It’s the source of truth for what you can capture — read it at runtime instead of hard-coding a surface list.

This endpoint is deliberately unauthenticated. GET /v1/surfaces and GET /v1/regions are the only /v1 routes that take no Authorization header, so an agent or client can enumerate what’s live before it has a key. The data is public and safe; every other /v1 route requires a valid Bearer token.

Request

curl https://api.aisearchapi.dev/v1/surfaces

const res = await fetch('https://api.aisearchapi.dev/v1/surfaces');
const { surfaces } = await res.json();
const live = surfaces.filter((s) => s.live).map((s) => s.id);

import requests

data = requests.get("https://api.aisearchapi.dev/v1/surfaces").json()
live = [s["id"] for s in data["surfaces"] if s["live"]]

Response

200 OK

{
  "surfaces": [
    { "id": "chatgpt", "live": true },
    { "id": "claude", "live": true },
    { "id": "perplexity", "live": true },
    { "id": "gemini", "live": false },
    { "id": "copilot", "live": true },
    { "id": "google_ai_overview", "live": true },
    { "id": "google_ai_mode", "live": true },
    { "id": "google_search", "live": true },
    { "id": "google_news", "live": true }
  ],
  "schemaVersion": "2026-06-27"
}

surfaces

object[]

Every surface in the enum with its current status.

Show surface

string

The surfaces enum value to send in a search request.

live

boolean

true when the surface is requestable today. false means a request for it returns 422 UNSUPPORTED_METHOD_FOR_SURFACE (e.g. gemini — see Surfaces).

schemaVersion

string

The current schema version, matching the X-AISearch-Version header.

Drive your integration off live rather than a hard-coded list. When a roadmap surface (like gemini) goes live, your code picks it up with no change — the request body and response Envelope stay identical.

Surfaces guide

Each surface, its enum value, and what’s live vs. phase 2.

Describe regions

The other public discovery endpoint: geo targeting.

Endpoints

Account & discovery

Watches

By surface

Request

Response

Surfaces guide

Describe regions

​Request

​Response

Surfaces guide

Describe regions

Request

Response