The Partner Network directory of partner programs a publisher can join to earn by recommending. Browse the catalog, then recommend (join) a program. The joined recommendations themselves are listed under Earn › Recommendations.
GET https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/recommendations
Paginated. Each row includes already_recommended — whether this publication already has a non-archived paid recommendation for that program.
Path Parameters
publication_uuid*
String
The publication a join would be attributed to.
Query Parameters
order_by
String
commission or max_payout. Defaults to newest first.
exclude_recommended
Boolean
When true, omit programs this publication already recommends (non-archived paid).
{
"recommendations": [
<Paid Recommendation Object>
],
"meta": {
"per_page": 50,
"page": 1,
"total_pages": 4,
"total_recommendations": 173
}
}GET https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/recommendations/:uuid
On a single entry the object also carries pre_approved — whether this publication is auto-approved to join. already_recommended is present as on the list.
Path Parameters
publication_uuid*
String
The viewing publication's UUID.
uuid*
String
The partner program's UUID.
POST https://api.sparkloop.app/v3/publications/:publication_uuid/earn/directory/recommendations/:recommendation_uuid/recommend
Starts recommending the program's publication. Returns the created Recommendation — status is active when pre-approved, or awaiting_approval when the program screens partners.
Path Parameters
publication_uuid*
String
The recommending publication's UUID.
recommendation_uuid*
String
The partner program's UUID.
Request Body
reason_for_recommending
String
The applicant's pitch. Required when the program screens partners.
{
"recommendation": <Paid Recommendation Object>
}{
"error": "Resource not found."
}{
"recommendation": <Recommendation Object>
}{
"error": "You are already recommending this publication."
}