# Endpoints & Authentication

One base URL, one search endpoint, one segmentation endpoint - all authenticated with the same token.

## Base URL

```bash
https://api.webz.io
```

## Search endpoint

Returns matching reviews as JSON.

`GET`

```bash
https://api.webz.io/reviewFilter
```

Both `GET` and `POST` are supported with the same parameters. `/api/reviews` is an alias of the same endpoint (`GET` only).

## Segmentation endpoint

Returns aggregate counts instead of reviews - see [Segmentation API](reviews-api-segmentation).

`GET`

```bash
https://api.webz.io/reviewSeg
```

`/seg_api/reviews` is an alias of the same endpoint.

## Authentication

Authenticate with your API token as a query parameter:

```bash
https://api.webz.io/reviewFilter?token=YOUR_TOKEN&q=laptop
```

A missing or unknown token returns `401 Unauthorized` with `Unknown API token`.