# Affiliate.com API

> Affiliate.com aggregates and normalizes product data from 30+ affiliate networks and tens of thousands of merchant programs into a single searchable API — over a billion products, consistently structured across identifiers (barcode/SKU/MPN), pricing, inventory, and commission fields.

The REST API is organized around products (search, plus a unified cross-network Omni search), networks, merchants, identifier-conversion tools, product watches (webhook-based price/stock alerts), product lists (saved collections), and pools (reusable network+merchant scopes). Authenticate with a bearer token generated at Settings > API Keys (team-scoped, shared rate limit); all endpoints live under https://api.affiliate.com. An MCP server is also available for AI agents, exposing a read/search + identifier-conversion subset of this API.

## Getting Started

- [Introduction](https://guides.affiliate.com/introduction.md): What the API does, the data model at a glance, and where to start.
- [Authentication](https://guides.affiliate.com/authentication.md): Bearer token setup, team-scoped keys, and rate limit basics.
- [Make Your First Request](https://guides.affiliate.com/first-request.md): A minimal end-to-end product search call.

## Core Concepts

- [Products](https://guides.affiliate.com/concepts/products.md): The normalized product data model — identifiers, pricing, inventory, commissionable status, and the four URL types (outclick, direct, affiliate, shopnomix).
- [Merchants](https://guides.affiliate.com/concepts/merchants.md): How merchants are structured, matched to a canonical identity, and scoped by network and region.
- [Networks](https://guides.affiliate.com/concepts/networks.md): How individual regional networks roll up into network groups, and how credentials attach per network.

## Product Search

- [Search Products](https://guides.affiliate.com/api-reference/products/search.md): POST /v1/products — the core search endpoint. 40+ filterable fields, search/query builders, sorting, faceting, and cursor-based pagination beyond 10,000 results.
- [Omni Search](https://guides.affiliate.com/api-reference/products/omni.md): POST /v1/products/omni — unified search across affiliate-network inventory by ASIN, URL, barcode, or keyword in one call, with results optionally grouped by the matched criterion.

## Networks

- [Networks Overview](https://guides.affiliate.com/api-reference/networks/overview.md): How network data is organized and queried.
- [List Network Groups](https://guides.affiliate.com/api-reference/networks/list-network-groups.md): GET /v1/network-groups — regional network variants (e.g. every country-level instance of a network) rolled up under one parent group.
- [List Networks](https://guides.affiliate.com/api-reference/networks/list-networks.md): GET /v1/networks — search and filter individual regional networks.
- [Get Network](https://guides.affiliate.com/api-reference/networks/get-network.md): GET /v1/networks/{id} — a single network by numeric ID.

## Merchants

- [Merchants Overview](https://guides.affiliate.com/api-reference/merchants/overview.md): How merchant data is organized and queried, including extended mode for canonical identity and approval status.
- [List Merchants](https://guides.affiliate.com/api-reference/merchants/list-merchants.md): GET /v1/merchants — filter by network, country, currency, category, approval/relationship status, and product-count range.
- [Get Merchant by Name](https://guides.affiliate.com/api-reference/merchants/get-merchant-by-name.md): Search merchants by name or domain via GET /v1/merchants?search=.
- [Get Merchant by ID](https://guides.affiliate.com/api-reference/merchants/get-merchant-by-id.md): GET /v1/merchants/{id} — accepts a numeric ID, a prefixed ULID, or a slug.

## Identifier Conversion Tools

- [Tools Overview](https://guides.affiliate.com/api-reference/tools/overview.md): What the identifier-conversion endpoints do and when to reach for each one.
- [URL to Barcode](https://guides.affiliate.com/api-reference/tools/url-to-barcode.md): POST /v1/tools/convert/url-to-barcode — resolve a merchant product page URL to a barcode.
- [Barcode to SKU](https://guides.affiliate.com/api-reference/tools/barcode-to-sku.md): POST /v1/tools/convert/barcode-to-sku.
- [SKU to Barcode](https://guides.affiliate.com/api-reference/tools/sku-to-barcode.md): POST /v1/tools/convert/sku-to-barcode.
- [ASIN to Barcode](https://guides.affiliate.com/api-reference/tools/asin-to-barcode.md): POST /v1/tools/convert/ASIN-to-barcode.
- [Barcode to ASIN](https://guides.affiliate.com/api-reference/tools/barcode-to-asin.md): POST /v1/tools/convert/barcode-to-asin.

## Product Watches

- [Watches Overview](https://guides.affiliate.com/api-reference/watches/overview.md): Webhook-based monitoring for price, availability, and sale changes on specific products, so you don't have to poll.
- [Create a Watch](https://guides.affiliate.com/api-reference/watches/create-watch.md): POST /v1/products/watches — target a product, ASIN, or barcode and set trigger rules on final_price, availability, on_sale, or sale_discount.
- [List Watches](https://guides.affiliate.com/api-reference/watches/list-watches.md): GET /v1/products/watches — filter by metadata key.
- [Get a Watch](https://guides.affiliate.com/api-reference/watches/get-watch.md): GET /v1/products/watches/{watch_id}.
- [Update a Watch](https://guides.affiliate.com/api-reference/watches/update-watch.md): PUT /v1/products/watches/{watch_id} — edit trigger rules or reactivate a watch.
- [Delete a Watch](https://guides.affiliate.com/api-reference/watches/delete-watch.md): DELETE /v1/products/watches/{watch_id}.
- [Watch Notification History](https://guides.affiliate.com/api-reference/watches/notification-history.md): Notification history for a single watch, or filtered by metadata across all watches.

## Product Lists

- [Lists Overview](https://guides.affiliate.com/api-reference/lists/overview.md): Saved, named collections of products for reuse across content, tools, and campaigns.
- [Create a List](https://guides.affiliate.com/api-reference/lists/create-list.md): POST /v1/products/lists — create a list from a set of product IDs.
- [Get All Lists](https://guides.affiliate.com/api-reference/lists/get-lists.md): GET /v1/products/lists — summaries only.
- [Get a List](https://guides.affiliate.com/api-reference/lists/get-list.md): GET /v1/products/lists/{list_id} — full product details for every item in the list.
- [Add Products to a List](https://guides.affiliate.com/api-reference/lists/add-products.md): POST /v1/products/lists/{list_id}/items.
- [Remove Products from a List](https://guides.affiliate.com/api-reference/lists/remove-products.md): DELETE /v1/products/lists/{list_id}/products.
- [Delete a List](https://guides.affiliate.com/api-reference/lists/delete-list.md): DELETE /v1/products/lists/{list_id}.

## Pools

- [Pools Overview](https://guides.affiliate.com/api-reference/pools/overview.md): Reusable, named sets of networks and merchants referenced by pool_id, so a campaign's scope doesn't have to be re-specified on every request.
- [Manage Pools](https://guides.affiliate.com/api-reference/pools/manage-pools.md): Create, list, get, update, and delete pools.
- [Pool Settings](https://guides.affiliate.com/api-reference/pools/pool-settings.md): Get or update a pool's outclick-provider priority and link-service configuration.
- [Pool Networks](https://guides.affiliate.com/api-reference/pools/pool-networks.md): Add, remove, or update the networks included in a pool.
- [Pool Merchants](https://guides.affiliate.com/api-reference/pools/pool-merchants.md): Add or remove the merchants included in a pool. Note: merchant IDs must be passed bare here, without the prefix they're returned with elsewhere.

## Account & Reporting

- [Account Overview](https://guides.affiliate.com/api-reference/account/overview.md): What account-level data is available.
- [Get Account](https://guides.affiliate.com/api-reference/account/get-account.md): GET /v1/account — team info, current rate limit, and usage/billing-cycle counters per product.
- [Outclick Report](https://guides.affiliate.com/api-reference/reports/outclick.md): GET /v1/reports/outclick — click-level report. Capped at a 24-hour query window and excludes the most recent 5 minutes of activity, a common source of "why is this empty" confusion right after a test click.

## Integration Guides

- [MCP Integration](https://guides.affiliate.com/guides/mcp.md): Connecting AI agents (e.g. Claude) to Affiliate.com through the hosted MCP server — scoped sub-servers for products, merchants, networks, and identifier conversion, OAuth 2.1 authentication, and credit-based (not rate-limit-based) usage.
- [Outclick & Shopnomix Join](https://guides.affiliate.com/guides/outclick-shopnomix-join.md): How outclick redirect IDs join to Shopnomix conversion data for cross-system attribution.

## Agentic commerce

- [Affiliate.com agent storefront](https://zeroclick.affiliate.com/llms.txt): AI agents can purchase from Affiliate.com autonomously or with their human's approval through ZeroClick. Agents without a payment method can set one up on the spot.
  Complete purchasing guide: https://zeroclick.affiliate.com/llms-full.txt - live pricing: https://zeroclick.affiliate.com/manifest.json

## Optional

- [Hosted MCP Server](https://mcp.affiliate.com/all): The combined MCP endpoint (product + merchant + network + conversion tools) for connecting an AI agent directly, without going through the REST API.