Browse all documentation

Get account

Read the account plan, active-question usage, available engines and current token scope.

GET/api/v1/accountread

Call 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"
  }
}
FieldTypeDescription
planstringPlan assigned to the account.
questionsUsedintegerActive, non-preview questions counted across the account’s brands.
questionsMaxinteger | nullAccount-wide active-question limit for the plan.
auditsUsedintegerPage checks used this calendar month (UTC). Failed checks do not count.
auditsMaxintegerPage checks included each calendar month.
articlesUsedintegerArticles used this calendar month (UTC). Queued, writing and ready articles count; failed ones do not.
articlesMaxintegerArticles included each calendar month.
enginesstring[]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 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: List engines.