> ## Documentation Index
> Fetch the complete documentation index at: https://guides.affiliate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Affiliate.com API overview and getting started guide

> The Affiliate.com API gives you programmatic access to over a billion affiliate products across hundreds of networks and merchants worldwide.

The Affiliate.com API is a REST API that lets you search and retrieve affiliate product data from networks like Impact, Rakuten, Awin, and many more. You can search products, set price-drop watches, build curated product lists, and convert identifiers — all from a single API key.

All API requests go to the base URL:

```
https://api.affiliate.com
```

The API only accepts HTTPS connections. HTTP requests receive an HTTP 301 redirect to the equivalent HTTPS resource. All responses are JSON.

## Get your API token

To make requests, you need an API token. You can create one at [app.affiliate.com](https://app.affiliate.com/).

<Steps>
  <Step title="Sign in to app.affiliate.com">
    Go to [app.affiliate.com](https://app.affiliate.com/) and sign in to your account.
  </Step>

  <Step title="Open API Keys">
    In the left sidebar, click **API Keys** under the Settings section.
  </Step>

  <Step title="Create a key">
    Click **+ Create API Key**, give it a name, and copy it somewhere safe — you won't be able to view it again.
  </Step>

  <Step title="Add the token to your requests">
    Include the token in the `Authorization` header of every API request:

    ```http theme={null}
    Authorization: Bearer YOUR_API_TOKEN
    ```
  </Step>

  <Step title="Make your first request">
    Try listing available networks to confirm your token works:

    ```http theme={null}
    GET https://api.affiliate.com/v1/networks
    Authorization: Bearer YOUR_API_TOKEN
    ```
  </Step>
</Steps>

## Key capabilities

| Capability               | Description                                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------------------------- |
| **Product search**       | Search over a billion products across affiliate networks with filtering, sorting, and faceted results |
| **Watches**              | Monitor specific products for price changes or availability updates and receive notifications         |
| **Lists**                | Create and manage curated collections of affiliate products                                           |
| **Conversion tools**     | Convert between product identifiers — barcodes, SKUs, ASINs, and more                                 |
| **Networks & merchants** | Browse and filter the affiliate networks and merchants available in the platform                      |

## Common parameters

These parameters are available on all list endpoints:

| Parameter  | Type    | Default | Description                                               |
| ---------- | ------- | ------- | --------------------------------------------------------- |
| `fields`   | string  | —       | Comma-separated list of fields to include in the response |
| `page`     | integer | `1`     | Page number to retrieve                                   |
| `per_page` | integer | `100`   | Number of items per page                                  |

## Response codes

| Code  | Meaning                                                                  |
| ----- | ------------------------------------------------------------------------ |
| `200` | Request succeeded                                                        |
| `401` | Missing, malformed, or invalid API token                                 |
| `422` | Usage limit exceeded for your subscription plan                          |
| `429` | Rate limit exceeded — too many requests per minute                       |
| `503` | Unexpected traffic spike; the server is usually back within five minutes |

## Rate limits

Rate limits are enforced per API key and measured in requests per minute. Your specific limit depends on your subscription plan. If you exceed the per-minute limit, you receive an `HTTP 429` response. If you exceed your plan's total usage limit, you receive an `HTTP 422` response.

If you receive an `HTTP 503`, wait a few minutes before retrying. For persistent `5XX` errors, contact support at [support@affiliate.com](mailto:support@affiliate.com).