Open data and API

Klibon's directory of affiliate programs is open data. Read it as JSON, as markdown or over MCP, with no key and no account, and reuse it in your own site, tool or agent under CC BY 4.0.

GET
https://klibon.com/api/v1/open/programs

What is open

Exactly what the directory shows a visitor: every program that is active, listed and tracked by Klibon, with the terms its merchant set. That is the commission on each product, whether it recurs, the cookie window, the refund window, the minimum payout, how affiliates are approved, the promotion rules and where to join.

Nothing else is published. No affiliate, click, sale, commission or statement, no merchant account, and no program its merchant paused or keeps unlisted. There is nothing to write: every endpoint here is a read.

License

The directory data is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). You may copy, republish and build on it, commercially included, as long as you credit Klibon and link to the directory or to the program's page. That link is also how your readers find the current terms, which a copy cannot promise.

credit
<a href="https://klibon.com/programs">Source: Klibon</a>, <a href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>

Product names, logos and descriptions belong to the companies they describe; the license covers the directory, not their trademarks. Every answer of the API carries the license in a license field and in a Link header.

The API

All under https://klibon.com, GET only, JSON, no authentication. CORS is open, so a page in a browser can call it directly.

GET /api/v1/open/programsThe programs, a page at a time, with filters. Each entry has the program's terms and where to join.
GET /api/v1/open/programs/{slug}One program in full: what the product is, what each product pays, the promotion rules, how affiliates are approved and paid.
GET /api/v1/open/categoriesThe categories that hold at least one program, with counts. The values the category filter takes.
GET /api/v1/openThis API described as JSON: the endpoints, the parameters and the license.

Filters

Every parameter of the list is optional. One the API does not know is refused with a 400 rather than ignored, so a filter that was dropped can never pass for one that matched.

qtext
Free text over product names and terms. Accent-insensitive.
categorytext
One of the categories the categories endpoint returns, in any case.
processorstripe · creem · polar · paddle · revenuecat · generic
Programs whose sales Klibon reads from this payment processor. generic is the Conversions API: payments the merchant reports from their own server.
recurringtrue · false
true keeps programs where at least one product pays on renewals; false, programs where nothing recurs.
min_commissionnumber, 0 to 100
A percentage: 20 means 20%. Matches percentage programs only, since a flat fee cannot be compared to a rate without the order value.
updated_sinceISO 8601 date
Only programs changed since then. What a mirror asks to stay current.
sortrecent · commission
recent (default) is most recently updated first; commission is highest percentage first.
limit1 to 100
Programs per answer. 24 by default.
offsetnumber
How many programs to skip. total in the answer says how many there are.
curl
curl "https://klibon.com/api/v1/open/programs?category=Marketing&recurring=true&min_commission=20"
200
{
  "total": 1,
  "limit": 24,
  "offset": 0,
  "programs": [
    {
      "slug": "acme",
      "name": "Acme",
      "url": "https://klibon.com/programs/acme",
      "markdown_url": "https://klibon.com/programs/acme.md",
      "website": "https://acme.com",
      "domain": "acme.com",
      "category": "Marketing",
      "logo_url": "https://acme.com/logo.png",
      "join_url": "https://klibon.com/programs/acme",
      "terms": "30% recurring (lifetime) · 60-day cookie",
      "commission": {
        "type": "percent",
        "percent": 30,
        "amount": null,
        "currency": null,
        "recurring": true,
        "duration_months": null
      },
      "cookie_days": 60,
      "earnings_per_sale": { "amount": 1470, "currency": "USD", "estimated": true, "up_to": false },
      "processors": ["stripe"],
      "updated_at": "2026-11-18T10:02:44.000Z"
    }
  ],
  "license": {
    "id": "CC-BY-4.0",
    "name": "Creative Commons Attribution 4.0 International",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Source: Klibon (https://klibon.com/programs), CC BY 4.0"
  }
}

One program

The detail adds everything the list leaves out. A program that is paused, unlisted or unknown answers 404.

curl
curl https://klibon.com/api/v1/open/programs/acme

Fields and units

commissiontype is percent or fixed. percent holds 30 for 30%. amount holds a flat fee in the smallest unit of currency (5000 is $50.00). Whichever does not apply is null. recurring says whether renewals pay, and duration_months for how long (null is for as long as the customer pays).
earnings_per_saleThe most one sale pays, in minor units, from the best product's list price. estimated when it is a percentage of that price, up_to when other products pay less. Null when no price is known.
cookie_daysHow many days a click counts.
processorsThe payment processors the program's sales are read from.
url, join_url, markdown_urlThe program's page on Klibon, which is also where an affiliate joins, and the same page as markdown.
approval_modeauto: the affiliate's link works on joining. manual: the merchant reviews each request.
refund_window_daysHow long a commission is held before it is approved, so a refund reverses it first.
min_payout_amount, payout_currencyWhat approved commissions must add up to before a statement is issued, in minor units.
productsEach product that earns: its price, its own commission, and price by price what one sale earns.
about, about_source, audienceWhat the product is and who it suits. about_source is merchant when the program's owner wrote it, uneed when it comes from the product's Uneed listing.
promotion_rules, promotion_resourcesWhat the merchant allows when promoting the product, and the assets it hands affiliates.
updated_atWhen the program last changed, ISO 8601 in UTC.

Fields are added over time and never repurposed: read the ones you know and ignore the rest.

Limits and errors

120 requests a minute per address. Past that the API answers 429 with a Retry-After header. Answers may be cached for a few minutes, so a change a merchant just saved can take that long to show. An error is JSON with a sentence and a stable data.code: invalid_params, not_found or rate_limited.

400
{
  "statusCode": 400,
  "statusMessage": "Invalid parameters: unknown parameter \"network\" (accepted: q, category, …)",
  "data": { "code": "invalid_params" }
}

Markdown

Every program page has a markdown version at the same address with .md added, and the directory has one at /programs.md. Both pages also answer in markdown to a request that sends Accept: text/markdown. It is the same text as the page: terms, what each product pays, the promotion rules and the questions affiliates ask.

curl
curl https://klibon.com/programs/acme.md

# or the page itself, asking for markdown
curl -H "Accept: text/markdown" https://klibon.com/programs/acme

MCP server

The same directory is served to AI assistants over the Model Context Protocol, read-only and with no account. The tools return the same fields as this API. See MCP server for connecting Claude, ChatGPT or Cursor.

endpoint
https://mcp.klibon.com/mcp

llms.txt and structured data

/llms.txt describes Klibon, this directory and every address above in one plain file, for an assistant that starts from the domain. Each program page also carries schema.org structured data: the program, the company behind it and its questions.