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

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