# Response Format

Search responses are JSON: a `reviews` array plus paging metadata.

```json
{
  "reviews": [
    {
      "item": {
        "site": "amazon.com",
        "title": "Acme Blender 3000",
        "reviews_count": 124,
        "country": "US",
        "...": "..."
      },
      "uuid": "6bd4f2f1a2...",
      "url": "https://www.amazon.com/...",
      "author": "jane",
      "published": "2026-07-03T08:12:00.000+03:00",
      "title": "Great value",
      "text": "Full review text...",
      "language": "english",
      "rating": 4.5,
      "crawled": "2026-07-03T09:00:00.000+03:00",
      "...": "..."
    }
  ],
  "totalResults": 1843,
  "moreResultsAvailable": 1743,
  "next": "/reviewFilter?token=YOUR_TOKEN&format=json&ts=1751536320000&q=...",
  "requestsLeft": 989
}
```

## Envelope fields

| Field | Type | Description |
| --- | --- | --- |
| `reviews` | array | Matching reviews - see [Review Data Fields](reviews-api-data-fields) |
| `totalResults` | integer | Total reviews matching the query |
| `moreResultsAvailable` | integer | Reviews still available after this page |
| `next` | string | Relative URL of the next page. Append it to `https://api.webz.io` - see [Pagination](reviews-api-pagination) |
| `requestsLeft` | integer | Your remaining credit balance |

The same paging values are also returned as response headers `X-WebHose-Next` and `X-WebHose-Requests-Left`.

> [!NOTE]
> Envelope fields are camelCase (`totalResults`), unlike the News, Blogs & Forums APIs which use snake_case (`total_results`).

## Other formats

Set `format=xml` for XML, `format=rss` for an RSS feed of the newest matches, or `format=excel` for a spreadsheet download.