cURL
curl -X POST https://api.getcatalog.ai/v1/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"
]
}'
const response = await fetch('https://api.getcatalog.ai/v1/affiliate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
body: JSON.stringify({
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'
]
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.getcatalog.ai/v1/affiliate',
headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
json={
'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 = response.json()
{
"results": [
{
"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
}
],
"total_processed": 3,
"successful": 3,
"failed": 0
}
API Reference
Generate Affiliate Links
Convert URLs to affiliate links using the Wildfire network.
POST
/
v1
/
affiliate
cURL
curl -X POST https://api.getcatalog.ai/v1/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"
]
}'
const response = await fetch('https://api.getcatalog.ai/v1/affiliate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
body: JSON.stringify({
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'
]
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.getcatalog.ai/v1/affiliate',
headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
json={
'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 = response.json()
{
"results": [
{
"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
}
],
"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
string
required
Your API key for authentication
Request Body
string[]
required
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
Array of affiliate link generation results, one for each input URL
Show Affiliate Link Result
Show Affiliate Link Result
string
Generated affiliate tracking link (empty string if generation failed)
string
Original product URL that was processed
string
Wildfire device ID used for link generation
boolean
Whether the affiliate link was successfully generated
string
Error message if link generation failed (only present when success is false)
number
Total number of URLs processed in this request
number
Number of URLs that successfully generated affiliate links
number
Number of URLs that failed to generate affiliate links
cURL
curl -X POST https://api.getcatalog.ai/v1/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"
]
}'
const response = await fetch('https://api.getcatalog.ai/v1/affiliate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
body: JSON.stringify({
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'
]
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.getcatalog.ai/v1/affiliate',
headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
json={
'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 = response.json()
{
"results": [
{
"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
}
],
"total_processed": 3,
"successful": 3,
"failed": 0
}
- Not all product URLs may be supported by the Wildfire network
- Commission rates and tracking depend on Wildfire’s affiliate partnerships
⌘I