---
type: "firecrawl-provider"
description: "Affiliate networks, merchants, product search and identifier conversions (URL, barcode, ASIN) aggregated across Impact, Awin, Rakuten, CJ and other affiliate platforms."
use_when: "Affiliate platforms (groups such as Impact or Awin) and their regional networks (Impact US, Awin UK), with merchant and product counts. Network IDs filter merchant search.\n\nRetailers and brands on an affiliate network. A merchant has a numeric id, an `nmer_` id per network and a `mer_` canonical id across networks; link templates carry `{AFF_ID}`/`{SUB_ID}` slots.\n\nConvert between retailer product URLs, UPC/EAN barcodes, Amazon ASINs and merchant SKUs.\n\nAffiliate product listings with prices, availability and merchant URLs. Commission links are present when the account has a network link template. Unified search stays held."
categories: "Retail"
capabilities: 9
credits_per_call: 25
---
# Affiliate.com on Firecrawl Alexandria

Affiliate networks, merchants, product search and identifier conversions (URL, barcode, ASIN) aggregated across Impact, Awin, Rakuten, CJ and other affiliate platforms.

- Categories: Retail
- Category index: [Retail category](https://alexandria.firecrawl.dev/agents/categories/retail)
- Provider key: `affiliate-com`
- Access: Firecrawl credits
- Cost: 25 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/affiliate-com)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/openapi.json)

## Capabilities

- [List networks](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/networks/list): Regional affiliate networks under `data` (each a platform in one market, such as Impact Canada), with `meta` holding total, current_page, last_page and per_page. Rows recorded on 2026-10-14 carry `countries` and `canonical_id`. The reference page also shows `group` and `country` objects. Either shape is accepted.
- [Network details](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/networks/get): One network under `data`, with description, links and created/updated timestamps when the API sends them. Upstream has served that record both as a single object (live, 2026-10-14) and as a one-element array (the reference page). This returns the object either way. An unknown id is HTTP 404, surfaced as not_found.
- [Network groups](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/networks/groups): Every affiliate platform brand (Impact, Awin, Rakuten, CJ, Amazon and others) as id and name under `data`. The reference page describes `page` and `per_page`, but a live call on 2026-10-23 that sent `per_page` still returned all 39 groups while `meta` repeated the requested page size and `last_page`. Those options are not accepted. When the returned list is longer than `meta.per_page`, or it already holds every group while `meta.last_page` is greater than 1, `meta` is rewritten to that single page.
- [Search merchants](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/merchants/search): Merchants under `data` with `meta` pagination (total, current_page, last_page, per_page). Always the extended merchant object: network, canonical merchant, categories, countries and per-provider link templates.
- [Merchant details](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/merchants/get): One extended merchant under `data`. The reference page shows a one-element list; the live API answers a single object. A `mer_` canonical ID resolves to the canonical merchant.
- [Product URL to barcode](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/identifiers/url-to-barcode): `data` maps each URL (as upstream normalises it) to an array of barcodes; `[]` means no match. `meta.to_total` counts URLs with at least one barcode.
- [ASIN to barcode](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/identifiers/asin-to-barcode): `data` maps each ASIN to an array of barcodes; `[]` means none found.
- [Barcode to ASIN](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/identifiers/barcode-to-asin): `data` maps each matched barcode to an array of `{ asin, locale }`; barcodes without a match are absent.
- [Search products](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/products/search): Products under `data`, with `meta` (total capped at 10,000 unless exact_total, current_page, last_page, per_page, after) and `facets` when asked. `direct_url` and `urls.direct` are the merchant page. `commission_url`, `urls.affiliate` and `urls.outclick` carry `@@@`/`###` placeholders when the account has a network link template, and are null when it does not. Product objects vary by merchant; undeclared fields are kept.

## 1. Choose this provider when

Affiliate platforms (groups such as Impact or Awin) and their regional networks (Impact US, Awin UK), with merchant and product counts. Network IDs filter merchant search.

Retailers and brands on an affiliate network. A merchant has a numeric id, an `nmer_` id per network and a `mer_` canonical id across networks; link templates carry `{AFF_ID}`/`{SUB_ID}` slots.

Convert between retailer product URLs, UPC/EAN barcodes, Amazon ASINs and merchant SKUs.

Affiliate product listings with prices, availability and merchant URLs. Commission links are present when the account has a network link template. Unified search stays held.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "affiliate-com",
  "capability": "networks/list",
  "options": {
    "search": "impact",
    "per_page": 2
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `search` (string): Case-insensitive name fragment, for example `impact` or `awin`. Example: `<search>`
- `per_page` (number): Networks per page, 1 to 100. Upstream default 100. Example: `10`
- `page` (number): Page number, starting at 1. Example: `10`
- `fields` (string): Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. Example: `id,name,logo_url`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "affiliate-com",
    capability: "networks/list",
    options: {
      search: "impact",
      per_page: 2,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "affiliate-com",
  "capability": "networks/list",
  "options": {
    "search": "impact",
    "per_page": 2
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "affiliate-com",
    "capability": "networks/list",
    "options": {
      "search": "impact",
      "per_page": 2
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'affiliate-com/networks/list' \
  --options '{"search":"impact","per_page":2}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "affiliate-com",
  "capability": "networks/list",
  "options": {
    "search": "impact",
    "per_page": 2
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "affiliate-com",
  "capability": "networks/list",
  "options": {
    "search": "impact",
    "per_page": 2
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "meta": {
    "total": 15,
    "from": 1,
    "to": 2,
    "current_page": 1,
    "last_page": 8,
    "per_page": 2,
    "fields": [
      "id",
      "object_id",
      "slug",
      "name",
      "url",
      "logo_url",
      "merchant_count",
      "merchant_count_active",
      "product_count",
      "promotion_count",
      "record_types",
      "merchant_network_types",
      "canonical_id",
      "countries"
    ],
    "trace_id": "01a13a8a-e345-7109-8b91-aa0736f650d7"
  },
  "data": [
    {
      "id": 336,
      "object_id": "rnet_01kkgbyq8k6n7nr20861gjv3nm",
      "slug": "rnet_61gjv3nm",
      "name": "Impact Australia",
      "url": "https://www.impact.com",
      "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
      "merchant_count": 177,
      "merchant_count_active": 115,
      "product_count": 5978286,
      "promotion_count": 0,
      "record_types": [
        "products"
      ],
      "merchant_network_types": [
        "standard"
      ],
      "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
      "countries": [
        "AU"
      ]
    },
    {
      "id": 341,
      "object_id": "rnet_01kkgbyqb3th2axrxp0yvrnfas",
      "slug": "rnet_0yvrnfas",
      "name": "Impact Canada",
      "url": "https://www.impact.com",
      "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
      "merchant_count": 85,
      "merchant_count_active": 74,
      "product_count": 3061924,
      "promotion_count": 0,
      "record_types": [
        "products"
      ],
      "merchant_network_types": [
        "standard"
      ],
      "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
      "countries": [
        "CA"
      ]
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### List networks

- Capability: `networks/list`
- Description: Regional affiliate networks under `data` (each a platform in one market, such as Impact Canada), with `meta` holding total, current_page, last_page and per_page. Rows recorded on 2026-10-14 carry `countries` and `canonical_id`. The reference page also shows `group` and `country` objects. Either shape is accepted.
- Instructions: Find which affiliate networks (Impact, Awin, Rakuten, CJ and their regional instances) Affiliate.com indexes, with merchant and product counts per network. Use the numeric id to filter merchants/search or read networks/get.
- Cost: 25 credits per call
- Capability file: [List networks](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/networks/list)

Accepted options:
- `search` (string): Case-insensitive name fragment, for example `impact` or `awin`. Example: `<search>`
- `per_page` (number): Networks per page, 1 to 100. Upstream default 100. Example: `10`
- `page` (number): Page number, starting at 1. Example: `10`
- `fields` (string): Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. Example: `id,name,logo_url`

Response schema example:
```json
{
  "meta": {
    "total": 15,
    "from": 1,
    "to": 2,
    "current_page": 1,
    "last_page": 8,
    "per_page": 2,
    "fields": [
      "id",
      "object_id",
      "slug",
      "name",
      "url",
      "logo_url",
      "merchant_count",
      "merchant_count_active",
      "product_count",
      "promotion_count",
      "record_types",
      "merchant_network_types",
      "canonical_id",
      "countries"
    ],
    "trace_id": "01a13a8a-e345-7109-8b91-aa0736f650d7"
  },
  "data": [
    {
      "id": 336,
      "object_id": "rnet_01kkgbyq8k6n7nr20861gjv3nm",
      "slug": "rnet_61gjv3nm",
      "name": "Impact Australia",
      "url": "https://www.impact.com",
      "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
      "merchant_count": 177,
      "merchant_count_active": 115,
      "product_count": 5978286,
      "promotion_count": 0,
      "record_types": [
        "products"
      ],
      "merchant_network_types": [
        "standard"
      ],
      "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
      "countries": [
        "AU"
      ]
    },
    {
      "id": 341,
      "object_id": "rnet_01kkgbyqb3th2axrxp0yvrnfas",
      "slug": "rnet_0yvrnfas",
      "name": "Impact Canada",
      "url": "https://www.impact.com",
      "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
      "merchant_count": 85,
      "merchant_count_active": 74,
      "product_count": 3061924,
      "promotion_count": 0,
      "record_types": [
        "products"
      ],
      "merchant_network_types": [
        "standard"
      ],
      "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
      "countries": [
        "CA"
      ]
    }
  ]
}
```

### Network details

- Capability: `networks/get`
- Description: One network under `data`, with description, links and created/updated timestamps when the API sends them. Upstream has served that record both as a single object (live, 2026-10-14) and as a one-element array (the reference page). This returns the object either way. An unknown id is HTTP 404, surfaced as not_found.
- Instructions: Read one affiliate network's merchant count, active merchants, product count and countries by its ID.
- Cost: 25 credits per call
- Capability file: [Network details](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/networks/get)

Accepted options:
- `id` (string, required): Numeric network ID from networks/list, or its `rnet_` object_id. Example: `rnet_`
- `fields` (string): Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. Example: `id,name,logo_url`

Response schema example:
```json
{
  "data": {
    "id": 335,
    "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
    "object_id": "rnet_01kkgbyq82ve56ywbmhm7pn95t",
    "slug": "rnet_hm7pn95t",
    "name": "Impact US",
    "url": "https://www.impact.com",
    "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
    "icon_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
    "merchant_count": 1699,
    "merchant_count_active": 1231,
    "product_count": 299908206,
    "promotion_count": 0,
    "countries": [
      "US"
    ],
    "record_types": [
      "products"
    ],
    "merchant_network_types": [
      "standard"
    ],
    "links": {
      "self": "https://api.affiliate.com/v1/networks/rnet_01kkgbyq82ve56ywbmhm7pn95t?extended=1",
      "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdhm?extended=1"
    },
    "description": "Impact US network",
    "created_at": "2026-03-12T06:32:43+00:00",
    "updated_at": "2026-10-14T12:00:16+00:00"
  },
  "meta": {
    "trace_id": "01a13a8b-3607-7336-9a82-4cd88db4331d"
  }
}
```

### Network groups

- Capability: `networks/groups`
- Description: Every affiliate platform brand (Impact, Awin, Rakuten, CJ, Amazon and others) as id and name under `data`. The reference page describes `page` and `per_page`, but a live call on 2026-10-23 that sent `per_page` still returned all 39 groups while `meta` repeated the requested page size and `last_page`. Those options are not accepted. When the returned list is longer than `meta.per_page`, or it already holds every group while `meta.last_page` is greater than 1, `meta` is rewritten to that single page.
- Instructions: List the affiliate platform brands Affiliate.com aggregates, before narrowing to their regional networks.
- Cost: 25 credits per call
- Capability file: [Network groups](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/networks/groups)

Accepted options:
- `fields` (string): Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. Example: `id,name,logo_url`

Response schema example:
```json
{
  "meta": {
    "total": 39,
    "from": 1,
    "to": 39,
    "current_page": 1,
    "last_page": 1,
    "per_page": 39,
    "fields": [
      "id",
      "name"
    ],
    "trace_id": "01a13a8a-e534-72b7-b8f5-c3830fac81b5"
  },
  "data": [
    {
      "id": 91,
      "name": "Amazon"
    },
    {
      "id": 92,
      "name": "Levanta"
    },
    {
      "id": 93,
      "name": "Wayward"
    }
  ]
}
```

### Search merchants

- Capability: `merchants/search`
- Description: Merchants under `data` with `meta` pagination (total, current_page, last_page, per_page). Always the extended merchant object: network, canonical merchant, categories, countries and per-provider link templates.
- Instructions: Find retailers and brands across affiliate networks by name or domain, and see which network carries them, how many products they list, their categories and countries, and link templates to fill with your own publisher ID.
- Cost: 25 credits per call
- Capability file: [Search merchants](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/merchants/search)

Accepted options:
- `search` (string): Case-insensitive fragment of the merchant name or home_url, for example `Walmart` or `walmart.com`. Does not match IDs. Example: `<search>`
- `network_ids` (string): Comma-separated numeric network IDs, as in a merchant's `network.id`. Example: `network.id`
- `origin_ids` (string): Comma-separated merchant IDs as the source network assigns them. Example: `<origin_ids>`
- `canonical_ids` (string): Comma-separated canonical `mer_` merchant IDs. Example: `mer_`
- `category_ids` (string): Comma-separated `cat_` category IDs. Example: `cat_`
- `category_name` (string): Category name filter. Example: `<category_name>`
- `countries` (string): Comma-separated ISO 3166-1 alpha-2 codes the merchant operates in, for example `US,CA`. Example: `US,CA`
- `countries_origin` (string): Comma-separated codes for the merchant's origin country. Example: `<countries_origin>`
- `countries_market` (string): Comma-separated codes for the merchant's market countries. Example: `<countries_market>`
- `currencies` (string): Comma-separated ISO 4217 codes. Example: `<currencies>`
- `feed_languages` (string): Comma-separated ISO 639-1 codes of the product feed. Example: `<feed_languages>`
- `merchant_types` (string): Comma-separated: `standard`, `asn` (Amazon Seller Network). Example: `<merchant_types>`
- `product_count_min` (number): Only merchants with at least this many products. Example: `10`
- `product_count_max` (number): Only merchants with at most this many products. Example: `10`
- `promotion_count_min` (number): Only merchants with at least this many promotions. Example: `10`
- `promotion_count_max` (number): Only merchants with at most this many promotions. Example: `10`
- `has_commissionable_url` (number): `1` keeps only merchants with a stored commissionable URL template. Not a test for linkability: read providers[].template instead. Example: `1`
- `per_page` (number): Merchants per page, 1 to 50. Defaults to 10 here; merchant records are large. Example: `10`
- `page` (number): Page number, starting at 1. Example: `10`
- `fields` (string): Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. Example: `id,name,logo_url`

Response schema example:
```json
{
  "meta": {
    "total": 62,
    "from": 1,
    "to": 1,
    "current_page": 1,
    "last_page": 62,
    "per_page": 1,
    "fields": [
      "id",
      "object_id",
      "slug",
      "origin_id",
      "name",
      "description",
      "domains",
      "home_url",
      "icon_url",
      "logo_url",
      "product_count",
      "cookie_duration",
      "supports_deeplinking",
      "categories",
      "countries",
      "currencies",
      "providers",
      "network",
      "canonical",
      "supports"
    ],
    "trace_id": "01a13a8a-e66c-7236-a837-c2fc4b6d4315"
  },
  "data": [
    {
      "id": 186149,
      "object_id": "nmer_01kya001cpdvkyfv85fsvqtnqe",
      "slug": "nmer_fsvqtnqe",
      "origin_id": null,
      "name": "Farberware - Walmart Seller",
      "description": null,
      "domains": [],
      "home_url": null,
      "icon_url": "https://placehold.co/112x32/EBF4FF/7F9CF56?text=Farberware+-+Walmart+Seller",
      "logo_url": "https://placehold.co/112x32/EBF4FF/7F9CF56?text=Farberware+-+Walmart+Seller",
      "product_count": 402,
      "cookie_duration": null,
      "supports_deeplinking": null,
      "categories": [],
      "countries": [
        "US"
      ],
      "currencies": [],
      "providers": [
        {
          "provider": "network",
          "status": null,
          "status_changed_at": null,
          "url": null,
          "template": null,
          "outclick": null,
          "supports_deeplinking": null,
          "deeplink": null,
          "approval": null
        }
      ],
      "network": {
        "id": 335,
        "slug": "rnet_hm7pn95t",
        "name": "Impact",
        "region": "US",
        "url": "https://www.impact.com",
        "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
        "icon_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
        "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
        "links": {
          "self": "https://api.affiliate.com/v1/networks/rnet_01kkgbyq82ve56ywbmhm7pn95t?extended=1",
          "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdhm?extended=1"
        }
      },
      "canonical": null,
      "supports": {
        "products": true,
        "services": false,
        "promotions": false
      }
    }
  ]
}
```

### Merchant details

- Capability: `merchants/get`
- Description: One extended merchant under `data`. The reference page shows a one-element list; the live API answers a single object. A `mer_` canonical ID resolves to the canonical merchant.
- Instructions: Read one merchant's full profile, network, canonical record and link templates by an ID from merchants/search.
- Cost: 25 credits per call
- Capability file: [Merchant details](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/merchants/get)

Accepted options:
- `id` (string, required): Merchant ID from merchants/search: numeric id, `nmer_` object_id, `mer_` canonical ID or slug. Example: `nmer_`

Response schema example:
```json
{
  "data": {
    "id": 102458,
    "object_id": "nmer_01khfn0gjh5z32n9bgav0000sn",
    "slug": "nmer_av0000sn",
    "origin_id": "9383",
    "name": "Walmart",
    "description": "Earn by referring customers to Walmart.com",
    "domains": [
      "https://walmart.com",
      "https://www.walmart.com"
    ],
    "home_url": "https://walmart.com",
    "icon_url": "https://img.affiliate.com/logos/merchants/102458/logo.png",
    "logo_url": "https://img.affiliate.com/logos/merchants/102458/logo.png",
    "product_count": 525667,
    "cookie_duration": null,
    "supports_deeplinking": true,
    "categories": [],
    "countries": [
      "US",
      "US"
    ],
    "currencies": [],
    "providers": [
      {
        "provider": "network",
        "status": null,
        "status_changed_at": null,
        "url": null,
        "template": "https://goto.walmart.com/c/{AFF_ID}/565706/9383?veh=aff&sourceid=imp_000011112222333344&u=https%3A%2F%2Fwww.walmart.com",
        "outclick": null,
        "supports_deeplinking": true,
        "deeplink": null,
        "approval": null
      },
      {
        "provider": "shopnomix",
        "status": null,
        "status_changed_at": null,
        "url": null,
        "template": "https://r.v2i8b.com/api/v1/bid/redirect?url=https%3A%2F%2Fwalmart.com&campaign_id={AFF_ID}&source={SUB_ID}",
        "outclick": null,
        "supports_deeplinking": true,
        "deeplink": {
          "domain": "walmart.com",
          "template": "https://r.v2i8b.com/api/v1/bid/redirect?url={target_url}&campaign_id={AFF_ID}&source={SUB_ID}"
        },
        "approval": null
      }
    ],
    "network": {
      "id": 335,
      "slug": "rnet_hm7pn95t",
      "name": "Impact",
      "region": "US",
      "url": "https://www.impact.com",
      "logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
      "icon_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
      "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
      "links": {
        "self": "https://api.affiliate.com/v1/networks/rnet_01kkgbyq82ve56ywbmhm7pn95t?extended=1",
        "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdhm?extended=1"
      }
    },
    "canonical": {
      "id": "mer_01kkk5eqt22cdgre41nfw42p4k",
      "slug": "mer_nfw42p4k",
      "name": "Walmart",
      "site_url": "https://walmart.com",
      "logo_url": null,
      "icon_url": null,
      "domains": {
        "walmart.ca": "mer_01kkjsyz2qqnwc84t9tdhnnbcq",
        "walmart.com": "mer_01kkjt853h7vdvq7bvn73dsvj2"
      },
      "domain_canonical_id": "mer_01kkjt853h7vdvq7bvn73dsvj2",
      "links": {
        "self": "https://api.affiliate.com/v1/merchants/mer_01kkk5eqt22cdgre41nfw42p4k?extended=1",
        "domain_canonical": "https://api.affiliate.com/v1/merchants/mer_01kkjt853h7vdvq7bvn73dsvj2?extended=1"
      }
    },
    "supports": {
      "products": true,
      "services": false,
      "promotions": false
    }
  },
  "meta": {
    "trace_id": "01a13a8b-3124-7362-9f63-77b7f1fa1e17"
  }
}
```

### Product URL to barcode

- Capability: `identifiers/url-to-barcode`
- Description: `data` maps each URL (as upstream normalises it) to an array of barcodes; `[]` means no match. `meta.to_total` counts URLs with at least one barcode.
- Instructions: Turn a retailer product page URL into its UPC/EAN barcodes, to look the same product up elsewhere.
- Cost: 25 credits per call
- Capability file: [Product URL to barcode](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/identifiers/url-to-barcode)

Accepted options:
- `urls` (string[], required): Full product page URLs from retailers such as Amazon, Walmart, Target, Home Depot or Best Buy; 1 to 10 per call. Example: `[]`

Response schema example:
```json
{
  "meta": {
    "from": "url",
    "to": "barcode",
    "from_total": 2,
    "to_total": 1,
    "trace_id": "01a13a8b-962a-724d-9836-e61b1dd38800"
  },
  "data": {
    "https://www.amazon.com/dp/B0C792QRW6": [
      "0887276760049",
      "8806095074122"
    ],
    "https://www.walmart.com/ip/14709523": []
  }
}
```

### ASIN to barcode

- Capability: `identifiers/asin-to-barcode`
- Description: `data` maps each ASIN to an array of barcodes; `[]` means none found.
- Instructions: Find the UPC/EAN barcodes behind Amazon ASINs, to match an Amazon listing to other retailers.
- Cost: 25 credits per call
- Capability file: [ASIN to barcode](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/identifiers/asin-to-barcode)

Accepted options:
- `asins` (string[], required): Amazon ASINs, 1 to 10 per call (upstream limit). Example: `[]`
- `locale` (string): Amazon marketplace, for example `US`, `GB`, `DE`. Defaults to `US`. Example: `US`

Response schema example:
```json
{
  "meta": {
    "from": "asin",
    "to": "barcode",
    "from_total": 2,
    "to_total": 2,
    "locale": "us",
    "config": {
      "asin": {
        "locale": "US"
      }
    },
    "trace_id": "01a13a8b-6afa-7024-9ab1-982cc9c2482e"
  },
  "data": {
    "B0C792QRW6": [
      "0887276760049",
      "8806095074122"
    ],
    "B00AQUO5RI": [
      "0615822003643",
      "0706487014362"
    ]
  }
}
```

### Barcode to ASIN

- Capability: `identifiers/barcode-to-asin`
- Description: `data` maps each matched barcode to an array of `{ asin, locale }`; barcodes without a match are absent.
- Instructions: Find the Amazon ASINs, and the marketplaces they are listed in, for a product barcode.
- Cost: 25 credits per call
- Capability file: [Barcode to ASIN](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/identifiers/barcode-to-asin)

Accepted options:
- `barcodes` (string[], required): Numeric UPC/EAN/GTIN barcodes, 1 to 10 per call. Example: `[]`

Response schema example:
```json
{
  "meta": {
    "from": "barcode",
    "to": "asin",
    "from_total": 2,
    "to_total": 2,
    "trace_id": "01a13a8b-6d3c-7099-a72d-9e12a7f1a2a1"
  },
  "data": {
    "8806095074122": [
      {
        "asin": "B0C792QRW6",
        "locale": "us"
      }
    ],
    "0887276760049": [
      {
        "asin": "B0C792QRW6",
        "locale": "us"
      }
    ]
  }
}
```

### Search products

- Capability: `products/search`
- Description: Products under `data`, with `meta` (total capped at 10,000 unless exact_total, current_page, last_page, per_page, after) and `facets` when asked. `direct_url` and `urls.direct` are the merchant page. `commission_url`, `urls.affiliate` and `urls.outclick` carry `@@@`/`###` placeholders when the account has a network link template, and are null when it does not. Product objects vary by merchant; undeclared fields are kept.
- Instructions: Search affiliate product listings by keyword, identifier, price, brand, merchant or network.
- Cost: 25 credits per call
- Capability file: [Search products](https://alexandria.firecrawl.dev/agents/providers/affiliate-com/products/search)

Accepted options:
- `keyword` (string): Plain-text search such as `JBL speaker`; sent as the string form of `search`. Example: `JBL speaker`
- `search` (object[]): Filter objects `{ field, value, operator }`, ANDed together. Fields include any, name, brand, category, barcode, sku, asin, merchant.id, network.id, final_price, currency, availability, on_sale, merchant.countries. Operators: =, !=, LIKE, NOT LIKE, >, <, >=, <=, NOT NULL. `||` in value ORs values. Example: `[]`
- `query` (object): Rule builder `{ rules_operator: any|all, rules: [{ conditions_operator, conditions: [{ field, operator, value }] }] }`. Exclusive with keyword and search. Example: `{}`
- `per_page` (number): Products per page, 1 to 50. Defaults to 10 here. Example: `10`
- `page` (number): Page number, starting at 1. Example: `10`
- `after` (string): Deep-pagination cursor from the previous response's meta.after, for results past 10,000 on plans that allow it. Example: `<after>`
- `exact_total` (boolean): Count meta.total past 10,000 precisely, at some extra latency. Example: `false`
- `fields` (string[]): Product fields to return, for example `id`, `name`, `final_price`, `urls`. Example: `[]`
- `sort_order` (string): Sort direction. Example: `asc`
- `duplicate_fields_to_exclude` (string): Deduplicate by name, image_url, direct_url, barcode or merchant.id. Comma syntax applies each independently and accepts `[N]` caps (`name,merchant.id[10]`); `a||b` drops a row when either has appeared. Example: `[N]`
- `facets` (string[]): Aggregations to include: network, merchant, final_price, or dotted sub-fields such as network.name. Example: `[]`
- `sort_by` (string): Sort field: relevance, id, barcode, ean, gtin, upc, isbn, asin, name, currency, regular_price, final_price, sale_discount, stock_quantity, commissionable_status, brand, category, color, gender, size, author, network.id, network.name, merchant.id, merchant.name, added_at, updated_at. Example: `relevance`
- `balanced_mix` (object): `{ field, max_per_value, interleave?, weights? }` to keep one merchant or brand from dominating. Not combinable with duplicate_fields_to_exclude. Example: `{}`

Response schema example:
```json
{
  "meta": {
    "total": 10000,
    "from": 1,
    "to": 3,
    "current_page": 1,
    "last_page": 3334,
    "per_page": 3,
    "fields": [
      "id",
      "barcode",
      "identifiers",
      "name",
      "description",
      "commission_url",
      "direct_url",
      "image_url",
      "urls",
      "currency",
      "regular_price",
      "final_price",
      "on_sale",
      "sale_discount",
      "availability",
      "stock_quantity",
      "commissionable_status",
      "seller_party",
      "mpn",
      "sku",
      "brand",
      "category",
      "size",
      "color",
      "gender",
      "material",
      "country",
      "condition",
      "genre",
      "manufacturer",
      "model",
      "author",
      "artist",
      "tags",
      "network",
      "merchant",
      "added_at",
      "updated_at"
    ],
    "after": null,
    "sort_by": "relevance",
    "sort_order": "desc",
    "trace_id": "01a16716-f687-70c6-9a85-b8cd42608ff9"
  },
  "data": [
    {
      "id": "1562760102161895929",
      "barcode": null,
      "identifiers": {
        "barcode": null,
        "ean": null,
        "gtin": null,
        "upc": null,
        "isbn": null,
        "mpn": null,
        "sku": null,
        "asin": null
      },
      "name": "Designer Shoes Hoka Bondi 9 Women's Running Shoes Comfortable Running Shoes Running ShoesAthletic Shoes Sneakers Challenger 8 Running Shoes Cou",
      "description": "DHgate",
      "commission_url": null,
      "direct_url": "https://uk.dhgate.com/product/designer-shoes-hoka-bondi-9-women-s-running/1124878301.html",
      "image_url": "http://www.dhresource.com/f3/albu/bw/y/15/5b5bca94-0c57-4382-a063-793f6a42aac6.jpg",
      "urls": {
        "outclick": null,
        "direct": "https://uk.dhgate.com/product/designer-shoes-hoka-bondi-9-women-s-running/1124878301.html",
        "affiliate": null,
        "shopnomix": null
      },
      "currency": "GBP",
      "regular_price": 61.89,
      "final_price": 61.89,
      "on_sale": false,
      "sale_discount": 0,
      "availability": "InStock",
      "stock_quantity": null,
      "commissionable_status": "assumed_commissionable",
      "seller_party": "unknown",
      "mpn": null,
      "sku": null,
      "brand": "DHgate",
      "category": "Apparel & Accessories > Shoes; Shoes & Accessories > Sports Shoes > Running Shoes",
      "size": null,
      "color": null,
      "gender": null,
      "material": null,
      "country": null,
      "condition": "new",
      "genre": null,
      "manufacturer": null,
      "model": null,
      "author": null,
      "artist": null,
      "tags": null,
      "network": {
        "id": 103,
        "object_id": "rnet_01kkgbynqh00gs5r1fzj0rg7pr",
        "slug": "rnet_zj0rg7pr",
        "name": "CJ",
        "region": "GB",
        "logo_url": "https://img.affiliate.com/logos/groups/10013/64x64.png",
        "icon_url": "https://img.affiliate.com/logos/groups/10013/64x64.png",
        "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdgz",
        "links": {
          "view": "https://api.affiliate.com/v1/networks/rnet_01kkgbynqh00gs5r1fzj0rg7pr?extended=1",
          "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdgz?extended=1"
        }
      },
      "merchant": {
        "id": 156276,
        "object_id": "nmer_01kht0wpscemjn5cnfvg4qv61v",
        "slug": "nmer_vg4qv61v",
        "name": "DHGate",
        "logo_url": "https://placehold.co/112x32/EBF4FF/7F9CF56?text=DHGate",
        "canonical_id": "mer_01kkjrqqj8jm7wa08d9ktrrj2w",
        "canonical_name": "DHGate",
        "origin_id": "3992613",
        "links": {
          "view": "https://api.affiliate.com/v1/merchants/nmer_01kht0wpscemjn5cnfvg4qv61v?extended=1",
          "canonical": "https://api.affiliate.com/v1/merchants/mer_01kkjrqqj8jm7wa08d9ktrrj2w?extended=1"
        }
      },
      "added_at": "2026-10-22 19:12:12",
      "updated_at": "2026-10-22 19:12:12"
    },
    {
      "id": "1227870045422291660",
      "barcode": "198328256121",
      "identifiers": {
        "barcode": "198328256121",
        "ean": "4069987117497",
        "gtin": null,
        "upc": "198328256121,198328256152,198328256107,198328256084,198328259788,198328256176,198328256213,198328259771,198328259719,198328259726,198328256169,198328256206,198328259757,198328259764,199215082588,198328256190,199204321285,198328259740,198328256138,198328259733,198338567378",
        "isbn": null,
        "mpn": "OOY23",
        "sku": null,
        "asin": null
      },
      "name": "HYPERBOOST RUN Running Shoes",
      "description": "Shop for HYPERBOOST RUN Running Shoes - Black at adidas.be! See all the styles and colours of HYPERBOOST RUN Running Shoes - Black at the official adidas Belgium online shop.",
      "commission_url": null,
      "direct_url": "https://www.adidas.be/en/hyperboost-run-running-shoes/KK2010.html",
      "image_url": "https://assets.adidas.com/images/w_1080,h_1080,f_auto,q_auto:sensitive,fl_lossy/cd841b9167c448c982a2e52dd04dbeaa_9366/HYPERBOOST_RUN_Running_Shoes_Black_KK2010_01_00_standard.jpg",
      "urls": {
        "outclick": null,
        "direct": "https://www.adidas.be/en/hyperboost-run-running-shoes/KK2010.html",
        "affiliate": null,
        "shopnomix": null
      },
      "currency": "EUR",
      "regular_price": 170,
      "final_price": 170,
      "on_sale": false,
      "sale_discount": 0,
      "availability": "InStock",
      "stock_quantity": 15,
      "commissionable_status": "assumed_commissionable",
      "seller_party": "unknown",
      "mpn": "OOY23",
      "sku": null,
      "brand": "Adidas",
      "category": "Shoes,Running Shoes; Shoes",
      "size": "11",
      "color": "Core Black / Cloud White / Core Black",
      "gender": "Men",
      "material": null,
      "country": null,
      "condition": null,
      "genre": null,
      "manufacturer": null,
      "model": null,
      "author": null,
      "artist": null,
      "tags": null,
      "network": {
        "id": 3002,
        "object_id": "rnet_01kkgbysfb2aq10tjddgeefms7",
        "slug": "rnet_dgeefms7",
        "name": "Awin",
        "region": "BE",
        "logo_url": "https://img.affiliate.com/logos/groups/10006/64x64.png",
        "icon_url": "https://img.affiliate.com/logos/groups/10006/64x64.png",
        "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdh2",
        "links": {
          "view": "https://api.affiliate.com/v1/networks/rnet_01kkgbysfb2aq10tjddgeefms7?extended=1",
          "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdh2?extended=1"
        }
      },
      "merchant": {
        "id": 122787,
        "object_id": "nmer_01khfn40fh7dd7kt14ranfb0sh",
        "slug": "nmer_ranfb0sh",
        "name": "adidas",
        "logo_url": "https://img.affiliate.com/logos/canonical_merchants/01kkk20669s1j8ah5bs5vgjx6n/logo.png",
        "canonical_id": "mer_01kkk20669s1j8ah5bs5vgjx6n",
        "canonical_name": "adidas",
        "origin_id": "77000",
        "links": {
          "view": "https://api.affiliate.com/v1/merchants/nmer_01khfn40fh7dd7kt14ranfb0sh?extended=1",
          "canonical": "https://api.affiliate.com/v1/merchants/mer_01kkk20669s1j8ah5bs5vgjx6n?extended=1"
        }
      },
      "added_at": "2026-10-22 07:23:57",
      "updated_at": "2026-10-22 07:23:57"
    },
    {
      "id": "1227870045843190577",
      "barcode": "198338450175",
      "identifiers": {
        "barcode": "198338450175",
        "ean": "4069999438658",
        "gtin": null,
        "upc": "198338450175,198338450021,198338450076,198338450106,198338450038,198338450205,198338450052,198338450229,198338450151,198338450182,198338450243,198338450090,198338450069,198338450113,199215071186,198338450144,199204325016,198338450083,198338450236,198338450168,198338567477",
        "isbn": null,
        "mpn": "OOY23",
        "sku": null,
        "asin": null
      },
      "name": "HYPERBOOST RUN Running Shoes",
      "description": "Shop for HYPERBOOST RUN Running Shoes - Green at adidas.be! See all the styles and colours of HYPERBOOST RUN Running Shoes - Green at the official adidas Belgium online shop.",
      "commission_url": null,
      "direct_url": "https://www.adidas.be/en/hyperboost-run-running-shoes/HQ9478.html",
      "image_url": "https://assets.adidas.com/images/w_1080,h_1080,f_auto,q_auto:sensitive,fl_lossy/988d59e3caa24cef91dd1bddc7aa6c1a_9366/HYPERBOOST_RUN_Running_Shoes_Green_HQ9478_01_00_standard.jpg",
      "urls": {
        "outclick": null,
        "direct": "https://www.adidas.be/en/hyperboost-run-running-shoes/HQ9478.html",
        "affiliate": null,
        "shopnomix": null
      },
      "currency": "EUR",
      "regular_price": 170,
      "final_price": 170,
      "on_sale": false,
      "sale_discount": 0,
      "availability": "InStock",
      "stock_quantity": 15,
      "commissionable_status": "assumed_commissionable",
      "seller_party": "unknown",
      "mpn": "OOY23",
      "sku": null,
      "brand": "Adidas",
      "category": "Shoes,Running Shoes; Shoes",
      "size": "10.5",
      "color": "Silver Pebble / Medium Dark Khaki / Frozen Lemon",
      "gender": "Men",
      "material": null,
      "country": null,
      "condition": null,
      "genre": null,
      "manufacturer": null,
      "model": null,
      "author": null,
      "artist": null,
      "tags": null,
      "network": {
        "id": 3002,
        "object_id": "rnet_01kkgbysfb2aq10tjddgeefms7",
        "slug": "rnet_dgeefms7",
        "name": "Awin",
        "region": "BE",
        "logo_url": "https://img.affiliate.com/logos/groups/10006/64x64.png",
        "icon_url": "https://img.affiliate.com/logos/groups/10006/64x64.png",
        "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdh2",
        "links": {
          "view": "https://api.affiliate.com/v1/networks/rnet_01kkgbysfb2aq10tjddgeefms7?extended=1",
          "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdh2?extended=1"
        }
      },
      "merchant": {
        "id": 122787,
        "object_id": "nmer_01khfn40fh7dd7kt14ranfb0sh",
        "slug": "nmer_ranfb0sh",
        "name": "adidas",
        "logo_url": "https://img.affiliate.com/logos/canonical_merchants/01kkk20669s1j8ah5bs5vgjx6n/logo.png",
        "canonical_id": "mer_01kkk20669s1j8ah5bs5vgjx6n",
        "canonical_name": "adidas",
        "origin_id": "77000",
        "links": {
          "view": "https://api.affiliate.com/v1/merchants/nmer_01khfn40fh7dd7kt14ranfb0sh?extended=1",
          "canonical": "https://api.affiliate.com/v1/merchants/mer_01kkk20669s1j8ah5bs5vgjx6n?extended=1"
        }
      },
      "added_at": "2026-10-22 07:24:27",
      "updated_at": "2026-10-22 07:24:27"
    }
  ],
  "links": {
    "self": "https://api.affiliate.com/v1/products",
    "first": "https://api.affiliate.com/v1/products?page=1",
    "prev": null,
    "next": "https://api.affiliate.com/v1/products?page=2"
  }
}
```
