# Affiliate.com API

## Docs

- [Affiliate.com API overview and getting started guide](https://guides.affiliate.com/introduction.md): The Affiliate.com API gives you programmatic access to over a billion affiliate products across hundreds of networks and merchants worldwide.
- [Authenticate your requests to the Affiliate.com API](https://guides.affiliate.com/authentication.md): Create an API token at app.affiliate.com and include it as a Bearer token in the Authorization header on every API request you make.
- [Your First Request](https://guides.affiliate.com/first-request.md): Make your first API request to search products and get affiliate links.
- [Networks and network groups in the Affiliate.com API](https://guides.affiliate.com/concepts/networks.md): Networks are affiliate platforms like Rakuten or Awin. Each network hosts merchants and their products. Use network IDs to scope product searches.
- [Merchants: retailers and brands within affiliate networks](https://guides.affiliate.com/concepts/merchants.md): Merchants are individual retailers within a network, like Levi's or Walmart. Use merchant IDs to scope product searches to specific sellers.
- [Affiliate product data model: fields and structure](https://guides.affiliate.com/concepts/products.md): A reference for the product data model — covering URLs, pricing, inventory, identifiers, attributes, and how to work with each field group.
- [Outclick + Shopnomix — join clicks to conversions](https://guides.affiliate.com/guides/outclick-shopnomix-join.md): Pull Affiliate.com outclick data and join it to Shopnomix conversions for the full click-to-sale picture.
- [Account API: team info, rate limits, and usage stats](https://guides.affiliate.com/api-reference/account/overview.md): Retrieve your team's identity, API rate limits, total request counts, and per-product billing cycle details in a single authenticated call.
- [GET /v1/account — retrieve account information](https://guides.affiliate.com/api-reference/account/get-account.md): Fetch your team's name, API rate limit, request counters, and per-product billing cycle data using your Bearer token. Returns team ID and product list.
- [Networks API: browse affiliate network data](https://guides.affiliate.com/api-reference/networks/overview.md): Explore affiliate network groups and individual regional networks, including merchant counts, product counts, logos, and country associations.
- [GET /v1/network-groups — list all network groups](https://guides.affiliate.com/api-reference/networks/list-network-groups.md): Retrieve a paginated list of affiliate network groups such as Impact, Awin, and Rakuten. Each record returns the group's unique integer ID and display name.
- [GET /v1/networks — list all affiliate networks](https://guides.affiliate.com/api-reference/networks/list-networks.md): Retrieve a paginated list of affiliate networks with merchant counts, product totals, logos, country data, and parent network group associations.
- [GET /v1/networks/{id} — get a specific network](https://guides.affiliate.com/api-reference/networks/get-network.md): Fetch a single affiliate network by its ID, returning its name, logo, merchant counts, product count, group, and country association.
- [Merchants API: find sellers across networks](https://guides.affiliate.com/api-reference/merchants/overview.md): The Merchants API returns full merchant profiles for every seller across all affiliate networks, including per-provider links and your standing, canonical records, categories, and more.
- [GET /v1/merchants — list and search merchants](https://guides.affiliate.com/api-reference/merchants/list-merchants.md): Retrieve a paginated list of merchants across affiliate networks. Each merchant object includes per-provider links and your standing, canonical records, categories, and more.
- [Find merchants by name or domain on Affiliate.com](https://guides.affiliate.com/api-reference/merchants/get-merchant-by-name.md): Use the search query parameter to find merchants by name fragment or domain. Combine with network_ids to narrow results to specific affiliate networks.
- [GET /v1/merchants/{id} — get a specific merchant](https://guides.affiliate.com/api-reference/merchants/get-merchant-by-id.md): Fetch a single merchant by numeric ID, nmer_ ULID, mer_ canonical ID, or slug. Returns the full merchant object including per-provider links and your standing, and the canonical record.
- [POST /v1/products — search affiliate products](https://guides.affiliate.com/api-reference/products/search.md): Search 1B+ affiliate products refreshed daily using filters, sorting, pagination, and faceted search across 40+ fields and multiple networks.
- [POST /products/omni — unified product search](https://guides.affiliate.com/api-reference/products/omni.md): Query Amazon and 1B+ affiliate products in one call. Search by ASIN, URL, barcode, or keyword with advanced filtering.
- [Tools API: convert between product identifiers](https://guides.affiliate.com/api-reference/tools/overview.md): Convert between barcodes, SKUs, ASINs, and retailer URLs using a consistent POST format. Results map each source value to its converted target or null.
- [Convert retailer product page URLs to barcodes](https://guides.affiliate.com/api-reference/tools/url-to-barcode.md): Submit product page URLs from major retailers and receive the corresponding barcodes. Returns an array per URL; empty array means no match was found.
- [Convert product barcodes to merchant-specific SKUs](https://guides.affiliate.com/api-reference/tools/barcode-to-sku.md): Look up the SKU a specific merchant uses for each barcode you provide. Requires a merchant name or URL in config. Returns null for unmatched barcodes.
- [Convert merchant-specific SKUs to product barcodes](https://guides.affiliate.com/api-reference/tools/sku-to-barcode.md): Resolve merchant-specific SKUs to their standard barcodes. Requires a merchant name or URL in the config object to identify the source catalog.
- [Convert Amazon ASINs to product barcodes](https://guides.affiliate.com/api-reference/tools/asin-to-barcode.md): Look up barcodes for Amazon Standard Identification Numbers. Requires an Amazon locale in config. Submit up to 10 ASINs per call; returns an array per ASIN.
- [Convert product barcodes to Amazon ASINs](https://guides.affiliate.com/api-reference/tools/barcode-to-asin.md): Resolve barcodes to Amazon ASINs and their marketplace locales. Each barcode can map to multiple ASIN-locale pairs across Amazon marketplaces.
- [Product Watch API: monitor price and availability](https://guides.affiliate.com/api-reference/watches/overview.md): Monitor affiliate products for price drops, availability changes, and sale events, and receive webhook notifications when your conditions are met.
- [POST /v1/products/watches — create a product watch](https://guides.affiliate.com/api-reference/watches/create-watch.md): Create a product watch to receive webhook notifications when price, availability, or sale conditions change on the products you specify.
- [GET /v1/products/watches — list your product watches](https://guides.affiliate.com/api-reference/watches/list-watches.md): Retrieve all product watches on your account, with optional metadata filtering and pagination to narrow results to a specific campaign or category.
- [GET /v1/products/watches/{watch_id} — get a watch](https://guides.affiliate.com/api-reference/watches/get-watch.md): Retrieve a single product watch by its ID, including its rules, filters, notification settings, expiration timestamp, and last check time.
- [PUT /v1/products/watches/{id} — update a watch](https://guides.affiliate.com/api-reference/watches/update-watch.md): Update an existing product watch to change its rules, webhook target, filters, or status — including reactivating a completed or expired watch.
- [DELETE /v1/products/watches/{id} — delete a watch](https://guides.affiliate.com/api-reference/watches/delete-watch.md): Permanently delete a product watch by its ID. The watch stops checking immediately and you will no longer receive notifications for it.
- [Product watch notification history and webhooks](https://guides.affiliate.com/api-reference/watches/notification-history.md): Retrieve the notification history for your product watches and understand the webhook payload formats for price changes, unavailability, and expiration.
- [Product Lists API: save and manage product sets](https://guides.affiliate.com/api-reference/lists/overview.md): Store named product collections in Affiliate.com without managing your own database. Tag lists with metadata and retrieve full product data on demand.
- [POST /v1/products/lists — create a product list](https://guides.affiliate.com/api-reference/lists/create-list.md): Create a named product list with one or more product IDs and optional metadata. Returns the new list ID and full product objects for every product added.
- [GET /v1/products/lists — retrieve your product lists](https://guides.affiliate.com/api-reference/lists/get-lists.md): Retrieve all product lists for your API key. Filter by metadata key:value pairs to find specific lists. Returns list summaries, not full product data.
- [GET /v1/products/lists/{id} — get list with products](https://guides.affiliate.com/api-reference/lists/get-list.md): Retrieve a single product list by ID, including full product objects with prices, affiliate URLs, images, availability, and all other product fields.
- [Add products to an existing product list](https://guides.affiliate.com/api-reference/lists/add-products.md): Append one or more product IDs to an existing list. Duplicate IDs are silently ignored and returned in ignored_product_ids so you can detect them.
- [Remove products from an existing product list](https://guides.affiliate.com/api-reference/lists/remove-products.md): Delete one or more product IDs from an existing list. IDs not found in the list are returned in ignored_product_ids rather than causing an error.
- [DELETE /v1/products/lists/{id} — delete a list](https://guides.affiliate.com/api-reference/lists/delete-list.md): Permanently delete a product list by ID. The list and all its stored product IDs are removed immediately and cannot be recovered afterwards.
- [Pools API: manage reusable network and merchant sets](https://guides.affiliate.com/api-reference/pools/overview.md): Create named sets of networks and merchants. Pass a pool_id to search endpoints to automatically scope results without repeating filter lists on every request.
- [Manage pools — create, get, update, delete](https://guides.affiliate.com/api-reference/pools/manage-pools.md): CRUD operations for pools: create a named set of networks and merchants, retrieve it by ID, update its contents, or delete it.
- [Pool settings — get and update](https://guides.affiliate.com/api-reference/pools/pool-settings.md): Retrieve or update the service and sync configuration for a pool.
- [Pool networks — add, remove, update](https://guides.affiliate.com/api-reference/pools/pool-networks.md): Add or remove networks from a pool, and configure affiliate credentials per network.
- [Pool merchants — add and remove](https://guides.affiliate.com/api-reference/pools/pool-merchants.md): Add or remove merchants from a pool.
- [GET /v1/reports/outclick — your account's outclick events](https://guides.affiliate.com/api-reference/reports/outclick.md): Retrieve the API click (outclick) events recorded for your account, enriched with the product, merchant, network, and client data captured at click time.

## OpenAPI Specs

- [openapi](https://guides.affiliate.com/openapi.yaml)