Generate Affiliate Links

Convert regular product URLs into Wildfire affiliate tracking links

Transform regular product URLs into affiliate tracking links using the Wildfire network. This endpoint generates trackable links that enable commission earning from product purchases made through your affiliate links.

Request

x-api-key · string · required

Your API key

Request Body

urls · array · required

Array of product URLs to convert into affiliate links (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"
]

Response

results · array

Array of affiliate link generation results, one for each input URL

Show Affiliate Link Result

wildfire_link · string

Generated Wildfire affiliate tracking link (empty if generation failed)

original_url · string

Original product URL that was processed

device_id · string

Wildfire device ID used for link generation

success · boolean

Whether the affiliate link was successfully generated

error · string

Error message if link generation failed (only present when success is false)

total_processed · number

Total number of URLs processed in this request

successful · number

Number of URLs that successfully generated affiliate links

failed · number

Number of URLs that failed to generate affiliate links

Error Responses

error · string

Error message describing what went wrong

details · string

Additional error details (when available)

cURL

curl -X POST https://api.getcatalog.ai/v1/affiliate \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_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"
    ]
  }'

Success Response

{
  "results": [
    {
      "wildfire_link": "https://wildfire.app/track?url=https%3A%2F%2Fwww.nike.com%2Ft%2Fair-force-1-07-mens-shoes-5QFp5Z%2FCW2288-111&device_id=wf_device_12345",
      "original_url": "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
      "device_id": "wf_device_12345",
      "success": true
    },
    {
      "wildfire_link": "https://wildfire.app/track?url=https%3A%2F%2Fwww.adidas.com%2Fus%2Fgazelle-shoes%2FBB5476.html&device_id=wf_device_12345",
      "original_url": "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
      "device_id": "wf_device_12345",
      "success": true
    }
  ],
  "total_processed": 2,
  "successful": 2
}

Important Notes

• Affiliate links are generated using your configured Wildfire device ID
• Not all product URLs may be supported by the Wildfire network
• Commission rates and tracking depend on Wildfire’s affiliate partnerships
• Always test generated links before using them in production