# Quickstart

Four steps from zero to your first reviews. All you need is an API token.

## 1. Get your token

Find your API `token` in your Webz.io dashboard. Every request needs it.

## 2. Run a query

`GET`

```bash
https://api.webz.io/reviewFilter?token=YOUR_TOKEN&q="pizza oven" language:english rating:>=4
```

In real requests, URL-encode the `q` value.

## 3. Read the response

The JSON response contains a `reviews` array plus paging fields:

```json
{
  "reviews": [ ... ],
  "totalResults": 1843,
  "moreResultsAvailable": 1743,
  "next": "/reviewFilter?token=YOUR_TOKEN&format=json&ts=1751536320000&q=...",
  "requestsLeft": 989
}
```

## 4. Get the next page

Append the `next` value to `https://api.webz.io` and call it again. Repeat until `moreResultsAvailable` reaches `0`. See [Pagination](reviews-api-pagination).

That's it - you are up and running. Next, sharpen your query with [Query Syntax](reviews-api-query-syntax) and [Filters](reviews-api-filters).

> [!TIP]
> By default you search reviews crawled in the last 3 days. Set `ts` to go further back - see [Time Range](reviews-api-time-range). Older data - up to the last **5 years** - is available via the [News, Blogs, Forums & Reviews Archive](archive-what-is).
