Browse all documentation

List engines

List recognized engines and identify which are available to the account.

GET/api/v1/enginesread

Call the corresponding list_engines MCP tool with JSON arguments. Supply brandId and other path values as named arguments when the endpoint has them.

Request details

Required scope: A valid read or write token.

Request example
curl --request GET \
  --url "https://searchseal.com/api/v1/engines" \
  --header "Authorization: Bearer $SEARCHSEAL_TOKEN"

Response fields

Response body example
{
  "items": [
    {
      "id": "google_aio",
      "name": "AI Overview",
      "inPlan": true,
      "surface": "app"
    },
    {
      "id": "chatgpt",
      "name": "ChatGPT",
      "inPlan": true,
      "surface": "app"
    },
    {
      "id": "gemini",
      "name": "Gemini",
      "inPlan": true,
      "surface": "app"
    },
    {
      "id": "perplexity",
      "name": "Perplexity",
      "inPlan": true,
      "surface": "api"
    },
    {
      "id": "grok",
      "name": "Grok",
      "inPlan": false,
      "surface": "api"
    },
    {
      "id": "claude",
      "name": "Claude",
      "inPlan": false,
      "surface": "api"
    },
    {
      "id": "deepseek",
      "name": "DeepSeek",
      "inPlan": false,
      "surface": "api"
    },
    {
      "id": "copilot",
      "name": "Copilot",
      "inPlan": false,
      "surface": "app"
    },
    {
      "id": "google_ai_mode",
      "name": "AI Mode",
      "inPlan": false,
      "surface": "app"
    },
    {
      "id": "claude_lite",
      "name": "Claude",
      "inPlan": false,
      "surface": "api"
    },
    {
      "id": "grok_lite",
      "name": "Grok",
      "inPlan": false,
      "surface": "api"
    },
    {
      "id": "sakana",
      "name": "Sakana",
      "inPlan": false,
      "surface": "api"
    }
  ],
  "meta": {
    "generatedAt": "2026-09-26T08:15:02.114Z",
    "timeZone": "Asia/Jakarta"
  }
}
FieldTypeDescription
idstringIdentifier accepted by the engines filter.
namestringHuman-readable engine name.
inPlanbooleanTrue when this engine is available to the account.
surfacestringThe engine’s usual answer source: app for the app people use, api for a provider API. This field does not identify individual API fallbacks or web-search availability.

Successful REST responses from this endpoint include the shown meta fields. Read about data-through dates.

Possible errors

  • 401 unauthorized — Authentication failed because the token is absent, unrecognized or revoked.
  • 403 forbidden — Account access or token permissions do not allow this request. Check the message for the cause.
  • 429 rate_limited — A quota was reached or could not be checked. Wait the Retry-After delay before retrying.
  • 500 server_error — The server failed to complete the operation.

For the shared error format, see status codes, quotas and retries. Next endpoint: OpenAPI schema.