AI High-Intent Audience

POST

/api/public/audiences/high-intent

Note: This endpoint is in development;

Available to advertiser and agency API keys and to API keys an advertiser shares with a publisher. Every key for an advertiser gets the same list, not only households attributed to one publisher. Only residential IP addresses are included.

IP addresses of households that Podscribe’s AI Optimization model ranks as most likely to convert for the advertiser. The model is retrained every week on the advertiser’s recent converters, and each household gets a score and a percentile rank among all scored households. The list comes from the latest scored week and includes households that have already purchased: to target only new households, remove the IP addresses returned by Existing Customers Audience. Rows are sorted by score, highest first, so the households most likely to convert come at the top of the file.

This endpoint utilizes a task system.

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

AI High-Intent Audience

const url = 'https://backend.podscribe.ai/api/public/audiences/high-intent';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"advertiser":"advertiser_lookup_name","topPercent":10,"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/high-intent"

payload = {
    "advertiser": "advertiser_lookup_name",
    "topPercent": 10,
    "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/high-intent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "advertiser": "advertiser_lookup_name", "topPercent": 10, "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

topPercent

Share of top-ranked households to return, in percent. For example, 10 returns households with a percentile of 90 or higher.

number

(1–50)

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, sorted by Score from highest to lowest:

Field	Type	Example	Description
IP	string	123.123.123.123	Residential IP address of the household, IPv4 or IPv6.
Score	number	0.8731	Model score for this advertiser. Comparable only within the same file.
Percentile	number	99.4	Percentile rank of the household among all scored households, 0.0–99.9.
Scored Week	string	2026-10-26	First day (UTC) of the week the scores were computed for.

AI High-Intent Audience

Request Bodyrequired

Example

Response Body

Result file

Request Body^required