# Quickstart

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

## 1. Get your token

Find your API `token` in your Webz.io dashboard. Every request needs it, and your account must be enabled for the Forums API.

## 2. Run a query

`GET`

```bash
https://api.webz.io/api/forums?token=YOUR_TOKEN&q="home battery" language:english
```

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

## 3. Read the response

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

```json
{
  "posts": [ ... ],
  "next": "/api/forums?q=...&ts=1751713632000&ni=6bd4f2...",
  "total_results": 12453,
  "more_results_available": 12353,
  "requests_left": 989
}
```

## 4. Get the next page

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

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

> [!TIP]
> By default you search the last 3 days. To go further back set `ts`. Forums content is searchable for roughly the last 31 days - see [Time Range & History](news-blogs-forums-time-range). Older data - up to the last **5 years** - is available via the [News, Blogs, Forums & Reviews Archive](archive-what-is).