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
}
}
API Reference
Generate Affiliate Links
Convert URLs to affiliate links using the Wildfire network.
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
Your API key for authentication
Request Body
Array of product URLs to convert into affiliate links (maximum 100 URLs per request)Requirements:URL sanitization: URLs are sanitized and normalized on the backend; client-side sanitization is not required.
- Must be a non-empty array
- Each entry must be a valid URL string
- Maximum 100 URLs per request
[
"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
Array of affiliate link generation results, one for each input URL
Show Affiliate Link Result
Show Affiliate Link Result
Generated affiliate tracking link (empty string if generation failed)
Original product URL that was processed
Wildfire device ID used for link generation
Whether the affiliate link was successfully generated
Error message if link generation failed (only present when success is false)
Pagination metadata for the results
Show Pagination Object
Show Pagination Object
Current page number (always 1 for this endpoint)
Number of items per page (equals the number of URLs in the request)
Total number of URLs processed (same as
total_processed)Total number of pages (always 1 for this endpoint)
Whether there is a next page (always false for this endpoint)
Whether there is a previous page (always false for this endpoint)
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
⌘I