Listener IDs (Episode)

GET

/api/public/episode/impression-listeners/{podscribe_episode_id}

Note: Pass advertiser to get that advertiser’s impressions, plus prefix listeners when the advertiser has an ad in the episode.

Anonymized listener IDs for an episode, each with its number of listens.

This endpoint utilizes a task system.

Please read the description of Get status of file processing to understand how it works.

Listener IDs (Episode)

const url = 'https://backend.podscribe.ai/api/public/episode/impression-listeners/example?week_lb=8';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import requests

url = "https://backend.podscribe.ai/api/public/episode/impression-listeners/example"

querystring = {"week_lb":"8"}

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

curl --request GET \
  --url 'https://backend.podscribe.ai/api/public/episode/impression-listeners/example?week_lb=8' \
  --header 'Authorization: Bearer <token>'

Path Parameters

podscribe_episode_id

required

string

The Podscribe episode ID

Query Parameters

week_lb

string

The number of weeks back to get data for

advertiser

string

Single advertiser lookup name the caller can access. Omit to include prefix listeners only.

Response Body

application/json

ID of the file processing task.

string<uuid>

status

Task status: pending, done or failed.

pending done failed

url

Link to download the result file. Returned once the file is ready.

string<uri>

Response example

{
  "status": "pending"
}

Result file

Field	Type	Example	Description
User Id	string	abcd1234efgh	An anonymized listener identifier.
Frequency	number	3	Number of qualifying listens for that listener.