directory

Search and filter the directory of affiliate programs (each compared by network, commission, cookie window, and a MODELLED value per referral). Use to answer 'best/highest-paying affiliate programs for X', or to find programs by category, network, recurring vs one-time, or minimum value. Returns a ranked, paginated list of full program records.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "What the programs are for, in plain words: a niche, product or audience ('vpn', 'skincare', 'pet supplements for a dog blog', 'recurring saas'). Read the same way as the site's search; results are the matching programs, best first, and `interpretation` says how the query was read."
    },
    "category": {
      "type": "string",
      "description": "Category key, e.g. saas, finance, hosting, crypto (see list_categories)."
    },
    "network": {
      "type": "string",
      "description": "Primary network bucket, e.g. Impact, CJ, Awin, In-house (see list_networks)."
    },
    "recurring": {
      "type": "boolean",
      "description": "true = only recurring-commission programs; false = only one-time."
    },
    "confidence": {
      "type": "string",
      "enum": [
        "confirmed",
        "network"
      ],
      "description": "confirmed = rate read on a page the program itself publishes (the brand's own site, or the program's own page on the network that runs it)."
    },
    "min_value": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum modelled value per referral in USD."
    },
    "sort": {
      "type": "string",
      "enum": [
        "value",
        "name",
        "cookie"
      ],
      "description": "Default value (highest modelled payout first)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Programs per page, 1-50, default 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset."
    }
  }
}

Get the full record for one affiliate program by its slug (commission, cookie, network, how it pays, requirements, sources, verification date, modelled value).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The program's slug as returned by search_affiliate_programs, e.g. 'nom-nom'."
    }
  },
  "required": [
    "slug"
  ]
}

List the program categories (the keys search_affiliate_programs accepts) with a count for each.

{
  "type": "object",
  "properties": {}
}

List the affiliate networks (the keys search_affiliate_programs accepts) with a count of programs on each.

{
  "type": "object",
  "properties": {}
}

Headline coverage: total programs, categories, networks, how many are verified against their own source, and how many the site lists that these tools leave out (with why).

{
  "type": "object",
  "properties": {}
}