Skip to main content
POST
/
v2
/
affiliate
cURL
curl -X POST https://api.getcatalog.ai/v2/affiliate \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CATALOG_API_KEY" \
  -d '{
    "urls": [
      "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
      "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
      "https://www.amazon.com/dp/B08XYZ123"
    ]
  }'

{
  "data": [
    {
      "wildfire_link": "https://wild.link/e?d=37430269&dc=www.nike.com&url=https%3A%2F%2Fwww.nike.com%2Ft%2Fair-force-1-07-mens-shoes-5QFp5Z%2FCW2288-111",
      "original_url": "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
      "device_id": "37430269",
      "success": true
    },
    {
      "wildfire_link": "https://wild.link/e?d=37430269&dc=www.adidas.com&url=https%3A%2F%2Fwww.adidas.com%2Fus%2Fgazelle-shoes%2FBB5476.html",
      "original_url": "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
      "device_id": "37430269",
      "success": true
    },
    {
      "wildfire_link": "https://wild.link/e?d=37430269&dc=www.amazon.com&url=https%3A%2F%2Fwww.amazon.com%2Fdp%2FB08XYZ123",
      "original_url": "https://www.amazon.com/dp/B08XYZ123",
      "device_id": "37430269",
      "success": true
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 3,
    "total_items": 3,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  },
  "meta": {
    "total_processed": 3,
    "successful": 3,
    "failed": 0
  }
}
When to use: Monetize product links by generating trackable affiliate URLs. Supports up to 100 URLs per request.

​
Request

​
x-api-key
string
required
Your API key for authentication

​
Request Body

​
urls
string[]
required
Array of product URLs to convert into affiliate links (maximum 100 URLs per request)Requirements:
  • Must be a non-empty array
  • Each entry must be a valid URL string
  • Maximum 100 URLs per request
Example:
[
  "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
  "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
  "https://www.amazon.com/dp/B08XYZ123"
]
URL sanitization: URLs are sanitized and normalized on the backend; client-side sanitization is not required.

​
Response

​
data
array
Array of affiliate link generation results, one for each input URL
​
pagination
object
Pagination metadata for the results
​
meta
object
Response metadata and summary statistics
cURL
curl -X POST https://api.getcatalog.ai/v2/affiliate \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CATALOG_API_KEY" \
  -d '{
    "urls": [
      "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
      "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
      "https://www.amazon.com/dp/B08XYZ123"
    ]
  }'

{
  "data": [
    {
      "wildfire_link": "https://wild.link/e?d=37430269&dc=www.nike.com&url=https%3A%2F%2Fwww.nike.com%2Ft%2Fair-force-1-07-mens-shoes-5QFp5Z%2FCW2288-111",
      "original_url": "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
      "device_id": "37430269",
      "success": true
    },
    {
      "wildfire_link": "https://wild.link/e?d=37430269&dc=www.adidas.com&url=https%3A%2F%2Fwww.adidas.com%2Fus%2Fgazelle-shoes%2FBB5476.html",
      "original_url": "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
      "device_id": "37430269",
      "success": true
    },
    {
      "wildfire_link": "https://wild.link/e?d=37430269&dc=www.amazon.com&url=https%3A%2F%2Fwww.amazon.com%2Fdp%2FB08XYZ123",
      "original_url": "https://www.amazon.com/dp/B08XYZ123",
      "device_id": "37430269",
      "success": true
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 3,
    "total_items": 3,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  },
  "meta": {
    "total_processed": 3,
    "successful": 3,
    "failed": 0
  }
}

​
Important Notes

  • Not all product URLs may be supported by the Wildfire network
  • Commission rates and tracking depend on Wildfire’s affiliate partnerships