Get account
Read the account plan, active-question usage, available engines and current token scope.
GET
/api/v1/accountreadCall the corresponding get_account 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/account" \
--header "Authorization: Bearer $SEARCHSEAL_TOKEN"Response fields
Response body example
{
"plan": "max",
"questionsUsed": 42,
"questionsMax": 400,
"auditsUsed": 12,
"auditsMax": 1000,
"articlesUsed": 3,
"articlesMax": 80,
"engines": [
"google_aio",
"chatgpt",
"gemini",
"perplexity"
],
"tokenScope": "read",
"meta": {
"generatedAt": "2026-09-26T08:15:02.114Z",
"timeZone": "Asia/Jakarta"
}
}| Field | Type | Description |
|---|---|---|
plan | string | Plan assigned to the account. |
questionsUsed | integer | Active, non-preview questions counted across the account’s brands. |
questionsMax | integer | null | Account-wide active-question limit for the plan. |
auditsUsed | integer | Page checks used this calendar month (UTC). Failed checks do not count. |
auditsMax | integer | Page checks included each calendar month. |
articlesUsed | integer | Articles used this calendar month (UTC). Queued, writing and ready articles count; failed ones do not. |
articlesMax | integer | Articles included each calendar month. |
engines | string[] | Engines currently available to the account. |
tokenScope | "read" | "write" | Permission scope of the token used for this request. |
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: List engines.