List questions
List a brand’s saved questions by creation time, newest first.
GET
/api/v1/brands/{brandId}/questionsreadCall the corresponding list_questions 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. Pass paging.nextCursor as cursor for the next page while paging.hasMore is true.
Request example
curl --request GET \
--url "https://searchseal.com/api/v1/brands/b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70/questions?status=active&limit=1" \
--header "Authorization: Bearer $SEARCHSEAL_TOKEN"Request parameters
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
brandId | path | Yes | uuid | An active brand ID returned by the brand list. |
status | query | No | "active" | "archived" | Select active or archived questions. Omit to include both states. |
limit | query | No | integer | Page size from 1 to 100; defaults to 100. |
cursor | query | No | string | Pass the previous response’s paging.nextCursor to continue the list. |
Response fields
Response body example
{
"items": [
{
"id": "e3a9d1e2-7b4c-4f60-8e2a-9c1d5b7f3e21",
"text": "best boutique hotel in ubud",
"originalText": null,
"country": "us",
"language": "en",
"status": "active",
"createdAt": "2026-08-02T03:11:45.000Z"
}
],
"paging": {
"nextCursor": "WyIyMDI2LTA4LTAyVDAzOjExOjQ1LjAwMFoiLCJlM2E5ZDFlMi03YjRjLTRmNjAtOGUyYS05YzFkNWI3ZjNlMjEiXQ",
"hasMore": true
},
"meta": {
"generatedAt": "2026-09-26T08:15:02.114Z",
"timeZone": "Asia/Jakarta"
}
}| Field | Type | Description |
|---|---|---|
id | uuid | Unique identifier for the question. |
text | string | Stored text submitted to the engine. |
originalText | string | null | Original English text retained for a translated question; otherwise null. |
country | string | null | Country setting attached to the question; not a guarantee of request origin. |
language | string | null | Language assigned to the stored question. |
status | "active" | "archived" | Scan eligibility: archived questions are excluded from future scans. |
createdAt | datetime | Timestamp recorded when the question was saved. |
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 inerrors.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 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: Add questions.