---
title: "Traffic availability by country"
method: GET
path: "/v1/traffic-availability"
tags: ["Traffic availability"]
---

# Traffic availability by country

`GET /v1/traffic-availability`

## Request

- Base URL: `https://api.feelingsurf.fr`
- URL: `https://api.feelingsurf.fr/v1/traffic-availability`
- Auth: HTTP bearer

Surfer-traffic availability per country, to guide a site's or template's location targeting. A country with `availability: none` has no surfers delivering visits, so targeting it yields nothing. A fixed reference dataset (~250 countries), returned in full — not paginated.

## Response `200`

Every country with its availability.

- object
  - `data` TrafficAvailability[]
    - `code` string: ISO 3166-1 alpha-2 country code.
    - `name` string: Localized country name.
    - `continent` string: ISO continent code (EU, AS, NA, AF, SA, OC, AN).
    - `availability` 'none' | 'low' | 'medium' | 'high': Relative volume of surfer traffic available in this country.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The request is not allowed. A banned or disabled account is rejected with `forbidden`; a site setting your plan does not include is rejected with `premium_required`.
- `429`: Too many requests — the per-account, per-minute rate limit was exceeded. Wait the number of seconds given in the `Retry-After` response header, then retry.

---

[API](https://skmtc.dev/feelingsurf/apis/feelingsurf-api.md) · [All operations](https://skmtc.dev/feelingsurf/apis/feelingsurf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feelingsurf/apis/feelingsurf-api/revisions/8b09d26880d6?raw)