Marketplace

List your program in the AgentRef marketplace so affiliates can discover and apply to it.

The AgentRef marketplace is a public directory where affiliates browse and apply to affiliate programs. Listing your program there gives you passive inbound reach – affiliates find you rather than waiting for your invites.

How it works

Programs listed as public appear in the marketplace with their commission rate, category, EPC (earnings per click), and conversion rate. Affiliates can filter by category, minimum commission, and performance metrics. When an affiliate applies, they either get auto-approved instantly (if your program has autoApproveAffiliates: true) or land in your pending applications queue for manual review.

A program must be fully set up – Stripe connected, tracking installed, and at least one active affiliate – before it becomes eligible for public listing.

List your program

1. Open program settings

   In the dashboard go to Programs, select your program, then open Settings > Marketplace. Set visibility to Public and fill in a short description and category. Save.

2. Confirm eligibility

   If your program is not yet fully ready, AgentRef will show which setup steps are incomplete. Fix those first – an incomplete program cannot appear publicly even if you set visibility to public.

You can also update marketplace settings via the programs API. Use marketplaceStatus: "draft" while preparing the listing, marketplaceStatus: "public" when it should appear publicly, or marketplaceStatus: "private" to hide it. Use applicationAccess: "open" for marketplace applications and applicationAccess: "invite_only" for invite-only programs.

Managing applications

When an affiliate applies from the marketplace, the application appears in Programs > [Your Program] > Applications. Each application shows the affiliate’s name, their optional introductory message, and the date applied.

• Auto-approved – if your program has autoApproveAffiliates: true, the affiliate is added immediately and receives their affiliate link.
• Pending review – if auto-approve is off, approve, decline, or block the application from the dashboard or Applications API.

Enabling autoApproveAffiliates reduces drop-off. Affiliates who apply and get an immediate link are far more likely to start promoting than those who wait for manual approval.

API reference

List marketplace programs

Returns all publicly listed programs. Available to affiliate API keys (scope marketplace:read).

cURL

curl "https://www.agentref.co/api/v1/marketplace/programs?sort=epc&minCommission=20&limit=20" \
  -H "Authorization: Bearer ak_aff_YOUR_KEY"

Query parameters

Parameter	Type	Description
category	string	Filter by category (e.g. saas, ecommerce)
minCommission	number	Minimum commission percentage
minEpc	number	Minimum earnings per click (USD)
sort	string	epc | conversionRate | commission | newest
limit	number	Max results (1–50, default 20)
page / offset	number	Pagination

Apply to a program

Submits an affiliate application. Requires an affiliate API key (scope marketplace:apply).

cURL

curl -X POST "https://www.agentref.co/api/v1/marketplace/apply/PROGRAM_ID" \
  -H "Authorization: Bearer ak_aff_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "I run a newsletter focused on SaaS tools with 8k subscribers."}'

The response includes a status field (auto_approved or pending) and a nextSteps array describing what the affiliate should do next.

Applying twice to the same program returns the existing application rather than creating a duplicate. The HTTP response code will be 200 instead of 201 in that case.

What’s next

Invite Affiliates

Invite affiliates directly without waiting for marketplace applications.

Conversions

See how commissions are created when affiliates drive sales.