List engines
List recognized engines and identify which are available to the account.
GET
/api/v1/enginesreadCall 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"
}
}| Field | Type | Description |
|---|---|---|
id | string | Identifier accepted by the engines filter. |
name | string | Human-readable engine name. |
inPlan | boolean | True when this engine is available to the account. |
surface | string | The 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 theRetry-Afterdelay 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.