> For the complete documentation index, see [llms.txt](https://docs.sparkloop.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkloop.app/api-v3/objects-schema/paid-recommendation-object.md).

# Paid Recommendation Object

## 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**

```json
{
  "uuid": "pp_abcdef123",
  "created_at": "2025-03-01T10:00:00.000Z",
  "terms": "Send engaged US subscribers.",
  "engagement_screening": { "days": 7 },
  "geo_restrictions": {
    "allow_worldwide_referrals": false,
    "allowed_countries": ["us", "ca"],
    "blocked_countries": [],
    "allowed_regions": []
  },
  "commission": 2.5,
  "max_payout": 500.0,
  "expected_earning_per_referral": 1.75,
  "screening_strictness": "very_fair",
  "expected_referral_confirmation_rate": 70,
  "already_recommended": false,
  "pre_approved": true,
  "publication": {
    "uuid": "pub_9ac1f2",
    "name": "The Morning Brew",
    "description": "Business news you'll actually enjoy.",
    "logo_url": "https://assets.sparkloop.app/logos/pub_9ac1f2.png",
    "url": "https://morningbrew.com"
  }
}
```