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

Offers

Offers

The partner-side catalog of offers a publication can join. Browse and filter the available offers, then recommend (join) one — which creates a joined offer, listed under Earn › Offers.

Browse the directory

GET https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/offers

Paginated.

Path Parameters

Name
Type
Description

publication_uuid*

String

The publication a join would be attributed to.

Query Parameters

Name
Type
Description

q

String

Free-text search across offer headline, brand, and publication name.

categories

Array

Filter by offer category. One or more of: b2b, education, finance, food_and_drink, health_fitness, kids_family, shopping_lifestyle, other.

conversion_types

Array

Filter by conversion type. One or more of: lead, click, action.

commission_type

String

Filter by commission type: fixed or percentage.

countries

String

Comma-separated ISO country codes (e.g. US,CA). Returns offers that accept referrals from any of them.

sort

String

newest (most recently activated). Defaults to a tiered payout ranking.

{
  "offers": [
    <Directory Offer Object>
  ],
  "meta": {
    "per_page": 50,
    "page": 1,
    "total_pages": 3,
    "total_offers": 118
  }
}

Get a directory offer

GET https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/offers/:uuid

Path Parameters

Name
Type
Description

publication_uuid*

String

The publication's UUID.

uuid*

String

The offer's UUID.

Recommend an offer

POST https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/offers/:offer_uuid/recommend

Joins the offer, returning it as a newly created joined offer.

Path Parameters

Name
Type
Description

publication_uuid*

String

The joining publication's UUID.

offer_uuid*

String

The directory offer's UUID.