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.
GET https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/offers
Paginated.
Path Parameters
publication_uuid*
String
The publication a join would be attributed to.
Query Parameters
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 https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/offers/:uuid
Path Parameters
publication_uuid*
String
The publication's UUID.
uuid*
String
The offer's UUID.
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
publication_uuid*
String
The joining publication's UUID.
offer_uuid*
String
The directory offer's UUID.
{
"offer": <Directory Offer Object>
}{
"error": "Resource not found."
}{
"offer": <Offer Recommendation Object>
}{
"error": "Offer already added"
}