For the complete documentation index, see llms.txt. This page is also available as Markdown.

Paid Recommendation Object

A browse-facing partner program in the Partner Network directory.

Field
Type
Description

uuid

String

Partner program UUID.

created_at

String

When the program was created (ISO 8601).

terms

String | null

The program's engagement terms.

engagement_screening

Object

days — how long a referral is held before it can confirm.

geo_restrictions

Object

Accepted-referral geography (see below).

commission

Number

What the program pays per referral.

max_payout

Number | null

Per-partner payout cap. null until a budget is set.

expected_earning_per_referral

Number | null

Commission scaled by the program's target confirmation rate.

screening_strictness

String | null

How aggressively referrals are screened: very_strict, strict, fair, or very_fair. Null until there's enough data.

expected_referral_confirmation_rate

Number | null

The program's target confirmation rate (0–100).

already_recommended

Boolean

Whether the viewing publication already has a non-archived paid recommendation for this program. Present on directory list and show.

pre_approved

Boolean

Whether the viewing publication is auto-approved to join. Present only on the single-entry show.

publication

Object

The publication running the program (Publication Object).

geo_restrictions

Field
Type
Description

allow_worldwide_referrals

Boolean

Whether referrals from anywhere are accepted.

allowed_countries

Array

Allowed country codes (empty when worldwide).

blocked_countries

Array

Blocked country codes.

allowed_regions

Array

Allowed US state codes, when restricted.

Example