Existing Customers Audience

POST

/api/public/audiences/prior-customers

Note: Available to advertiser and agency API keys and to API keys an advertiser shares with a publisher. The list covers every visit and purchase the advertiser’s Podscribe pixel recorded, not only visitors attributed to one publisher. Only residential IP addresses are included: mobile-network, data-center, satellite and corporate addresses are left out, and so is bot traffic. Each list also includes the home IP address of households matched to these visitors through their devices, hashed emails and mobile ad IDs.

IP addresses of households that purchased from the advertiser within the lookback window, online or offline.

This endpoint utilizes a task system.

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

Existing Customers Audience

const url = 'https://backend.podscribe.ai/api/public/audiences/prior-customers';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"advertiser":"advertiser_lookup_name","lookbackDays":90,"name":"example"}'
};

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/audiences/prior-customers"

payload = {
    "advertiser": "advertiser_lookup_name",
    "lookbackDays": 90,
    "name": "example"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

curl --request POST \
  --url https://backend.podscribe.ai/api/public/audiences/prior-customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "advertiser": "advertiser_lookup_name", "lookbackDays": 90, "name": "example" }'

Request Body^required

application/json

advertiser

required

Lookup name of the advertiser. Must be an advertiser this API key has access to.

string

Example

advertiser_lookup_name

lookbackDays

Number of days to include, counting today.

integer

(1–365)

name

Optional display name for the generated report.

string

(≤ 255 chars)

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

Result file format, one row per IP address:

Field	Type	Example	Description
IP	string	123.123.123.123	Residential IP address of the audience member, IPv4 or IPv6.
Last Seen At	string	2026-10-27 18:04:11	UTC date and time of the latest purchase from this household.

Existing Customers Audience

Request Bodyrequired

Example

Response Body

Result file

Request Body^required