---
title: "Audiences you can ask, with their size band and price per answer by grade."
method: GET
path: "/v1/interest-audiences"
tags: ["audiences"]
---

# Audiences you can ask, with their size band and price per answer by grade.

`GET /v1/interest-audiences`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/interest-audiences`
- Auth: none required

`open=1` keeps only audiences open to join from the caller's country. With a key and `mine=asking`, private audiences your team sponsors are listed too. Sizes are bands, never counts.

## Query parameters

- `q` string
- `country` string
- `lang` string
- `category` 'outdoors' | 'home' | 'family' | 'food_drink' | 'games_tech' | 'travel' | 'motoring' | 'work' | 'shopping' | 'pets' | 'seasonal'
- `open` '0' | '1'
- `mine` 'asking'

## Response `200`

OK

- AudiencesListResponse
  - `audiences` object[], required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `summary` string, required
    - `imageUrl` string, nullable, required
    - `status` 'draft' | 'recruiting' | 'live' | 'closed', required
    - `category` string, required
    - `geoAllow` string[], required
    - `languages` string[], required
    - `poolBand` 'under_50' | '50_200' | '200_500' | '500_plus', required
    - `prices` object, required
      - `grade1` integer, required
      - `grade2` integer, required
      - `grade3` integer, required
    - `headShareBps` integer, required
    - `payFromPence` integer, required
    - `geoOk` boolean, required
    - `sponsored` boolean, required
    - `expiresAt` string, nullable, required

## Other responses

- `400`: The request is not valid; `error.details.validation` lists the fixes.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)