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"
]
}'
const response = await fetch('https://api.getcatalog.ai/v2/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();
console.log(`Generated ${data.data.length} affiliate links`);
console.log(`Successful: ${data.meta.successful}, Failed: ${data.meta.failed}`);
import requests
response = requests.post(
'https://api.getcatalog.ai/v2/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()
print(f"Generated {len(data['data'])} affiliate links")
print(f"Successful: {data['meta']['successful']}, Failed: {data['meta']['failed']}")
{
"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"
]
}'
const response = await fetch('https://api.getcatalog.ai/v2/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();
console.log(`Generated ${data.data.length} affiliate links`);
console.log(`Successful: ${data.meta.successful}, Failed: ${data.meta.failed}`);
import requests
response = requests.post(
'https://api.getcatalog.ai/v2/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()
print(f"Generated {len(data['data'])} affiliate links")
print(f"Successful: {data['meta']['successful']}, Failed: {data['meta']['failed']}")
{
"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
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)
object
Pagination metadata for the results
Show Pagination Object
Show Pagination Object
number
Current page number (always 1 for this endpoint)
number
Number of items per page (equals the number of URLs in the request)
number
Total number of URLs processed (same as
total_processed)number
Total number of pages (always 1 for this endpoint)
boolean
Whether there is a next page (always false for this endpoint)
boolean
Whether there is a previous page (always false for this endpoint)
object
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"
]
}'
const response = await fetch('https://api.getcatalog.ai/v2/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();
console.log(`Generated ${data.data.length} affiliate links`);
console.log(`Successful: ${data.meta.successful}, Failed: ${data.meta.failed}`);
import requests
response = requests.post(
'https://api.getcatalog.ai/v2/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()
print(f"Generated {len(data['data'])} affiliate links")
print(f"Successful: {data['meta']['successful']}, Failed: {data['meta']['failed']}")
{
"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