Browse all documentation

Get brand

Read a brand’s details, active-question count, latest answer date and search-data indicators.

GET/api/v1/brands/{brandId}read

This operation is available through REST only.

Request details

Required scope: A valid read or write token.

Request example
curl --request GET \
  --url "https://searchseal.com/api/v1/brands/b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70" \
  --header "Authorization: Bearer $SEARCHSEAL_TOKEN"

Request parameters

NameLocationRequiredTypeDescription
brandIdpathYesuuidAn active brand ID returned by the brand list.

Response fields

Response body example
{
  "id": "b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70",
  "name": "Example Villas",
  "domain": "example.com",
  "location": "Ubud, Bali",
  "regions": [
    "id",
    "au"
  ],
  "languages": [
    "en",
    "id"
  ],
  "createdAt": "2026-08-01T09:30:00.000Z",
  "questionsActive": 24,
  "lastAnswerAt": "2026-09-26",
  "searchConnected": {
    "google": true,
    "bing": true
  },
  "meta": {
    "generatedAt": "2026-09-26T08:15:02.114Z",
    "timeZone": "Asia/Jakarta",
    "dataThrough": {
      "answers": "2026-09-26",
      "google": "2026-09-23",
      "bing": "2026-09-24"
    }
  }
}
FieldTypeDescription
…Includes the fields returned by the brand list.
questionsActiveintegerCount of active, non-preview questions belonging to the brand.
lastAnswerAtdate | nullLatest stored non-preview answer date, including incomplete answers.
searchConnected{ google, bing }google indicates a selected Search Console property. bing indicates saved Bing daily data; it is not a live connection check.

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

Possible errors

  • 400 invalid_request — An input failed validation. Field details may appear in 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.
  • 404 not_found — The resource is missing or unavailable to this account, including inactive brands.
  • 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 competitors.