For Developers

Free API & MCP Server

Access our full directory of affiliate programs via a free REST API or connect your LLM with our MCP server. No API key required. CORS enabled for browser requests.

REST API

Base URL: https://affiliateroll.com/api/v1

GET/programs

List and search affiliate programs. Returns paginated results with AffiliateRoll scores.

Parameters

qstringSearch by name or description

categorystringFilter by category slug

commission_typestringFilter: percentage, fixed, hybrid, tiered

sortstringSort: score (default), name, newest, commission

limitnumberResults per page (1-100, default 50)

offsetnumberPagination offset

GET/programs/:slug

Get detailed information about a specific program including score breakdown, reviews, and full description.

GET/categories

List all categories with program counts.

GET/categories/:slug

Get a category and all its programs.

Example: Search programs

Request

curl "https://affiliateroll.com/api/v1/programs?q=hosting&sort=score&limit=5"

Response

{
  "data": [
    {
      "name": "Kinsta",
      "slug": "kinsta",
      "description": "Premium managed WordPress hosting...",
      "commission": {
        "type": "percentage",
        "rate": "5% - 10%"
      },
      "cookie_duration_days": 60,
      "score": { "value": 87, "label": "Excellent" },
      "category": { "name": "Web Hosting", "slug": "web-hosting" }
    }
  ],
  "meta": {
    "total": 12,
    "limit": 5,
    "offset": 0,
    "has_more": true
  }
}

Example: Get program details

Request

curl "https://affiliateroll.com/api/v1/programs/amazon-associates"

Response

{
  "data": {
    "name": "Amazon Associates",
    "slug": "amazon-associates",
    "description": "Amazon's affiliate program...",
    "commission": {
      "type": "percentage",
      "rate": "1% - 10%"
    },
    "cookie_duration_days": 24,
    "payment_methods": ["Direct Deposit", "Check", "Amazon Gift Card"],
    "pros": ["Massive product selection", "Trusted brand"],
    "cons": ["Short cookie duration", "Low commission rates"],
    "score": {
      "value": 62,
      "label": "Great",
      "breakdown": {
        "commission": 8,
        "cookie_duration": 7,
        "minimum_payout": 15,
        "payment_methods": 10,
        "completeness": 10
      }
    },
    "reviews": []
  }
}

MCP Server

Connect any LLM that supports the Model Context Protocol to AffiliateRoll. Search programs, compare commissions, and get recommendations — all from your AI assistant.

Quick Setup

Install

cd mcp-server
npm install
npm run build

Claude Desktop Configuration

claude_desktop_config.json

{
  "mcpServers": {
    "affiliateroll": {
      "command": "node",
      "args": ["path/to/mcp-server/dist/index.js"]
    }
  }
}

Available Tools

search_programs

Search and filter affiliate programs by keyword, category, commission type, and sort by score

get_program

Get detailed info about a specific program including score breakdown, reviews, and full description

list_categories

List all affiliate program categories with program counts

get_category

Get a category and all its programs

compare_programs

Compare 2-5 programs side by side on commission, cookies, score, and more

Example Prompts

“What are the best affiliate programs for web hosting?”

“Compare NordVPN, ExpressVPN, and Surfshark affiliate programs”

“Find affiliate programs with at least 30% commission”

“Which e-commerce affiliate programs have the longest cookie duration?”

“Show me the top 10 programs by AffiliateRoll score”

CLI

Search and compare affiliate programs directly from your terminal. No API key needed.

Install & Run

npx affiliateroll search hosting
npx affiliateroll top 10
npx affiliateroll get shopify
npx affiliateroll compare shopify amazon-associates nordvpn
npx affiliateroll categories
npx affiliateroll category web-hosting

Commands

search [query]

Search programs with optional filters: -c category, -s sort, -t type, -n limit

get <slug>

Get full details for a program including score breakdown, pros/cons

categories

List all categories with program counts

category <slug>

Browse all programs in a category

compare <slug1> <slug2>

Side-by-side comparison of 2-5 programs with winner

top [n]

Top N programs ranked by AffiliateRoll Score

Embed Widgets

Add a live affiliate program table to your blog or website. The widget auto-updates as programs are added.

Quick Setup

Add the script tag and a container div to your page:

<!-- Top 5 programs overall -->
<div data-affiliateroll="top"></div>

<!-- Top 5 in a specific category -->
<div data-affiliateroll="web-hosting"></div>
<div data-affiliateroll="saas-software" data-limit="10"></div>

<!-- Include the script (once, before </body>) -->
<script src="https://www.affiliateroll.com/embed.js" async></script>

Options

data-affiliateroll="category-slug"

Category slug or 'top' for overall top programs

data-limit="5"

Number of programs to show (1-20, default: 5)

Direct iframe

You can also embed directly with an iframe:

<iframe
  src="https://www.affiliateroll.com/embed/web-hosting"
  width="100%"
  height="400"
  frameborder="0"
  loading="lazy"
  title="Top Web Hosting Affiliate Programs"
></iframe>

Rate Limits & Usage

No API key required — completely free and open
CORS headers enabled for browser-based applications
Rate limit: 100 requests per minute per IP
Data updates in real-time as programs are added or modified
Please provide attribution with a link back to AffiliateRoll when displaying our data