cURL
curl -X GET "https://api.getcatalog.ai/v2/listings?vendor=skims.com&page=1&page_size=2&collection_url=https://www.skims.com/collections/skims-sale" \
-H "x-api-key: $CATALOG_API_KEY"
const params = new URLSearchParams({
vendor: 'skims.com',
page: '1',
page_size: '2',
collection_url: 'https://www.skims.com/collections/skims-sale'
});
const response = await fetch(`https://api.getcatalog.ai/v2/listings?${params}`, {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} listings`);
console.log(`Page ${data.pagination.page} of ${data.pagination.total_pages}`);
import requests
response = requests.get(
'https://api.getcatalog.ai/v2/listings',
headers={'x-api-key': 'YOUR_API_KEY'},
params={
'vendor': 'skims.com',
'page': 1,
'page_size': 2,
'collection_url': 'https://www.skims.com/collections/skims-sale'
}
)
data = response.json()
print(f"Found {len(data['data'])} listings")
print(f"Page {data['pagination']['page']} of {data['pagination']['total_pages']}")
{
"data": [
{
"id": "b3fd62fe-56b3-4d24-8bb5-49485d04b4f7",
"url": "https://www.skims.com/products/cotton-fleece-short-ruby",
"name": "COTTON FLEECE SHORT | RUBY",
"images": [
{
"id": "f464d0fb-7b79-4f46-8c4a-d9f52e741787",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-SH-SHO-8419W-RBY-FLT.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 1
},
{
"id": "ae41651e-d41a-4f37-bc1b-99ae1546540f",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0001-FR.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 2
},
{
"id": "e19d3350-f474-4105-8ff5-da66503ef707",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0029-SD.jpg?v=1746030214",
"width": 1730,
"height": 1730,
"position": 3
},
{
"id": "b03ee465-81fa-46ed-bb8b-54783dfe04a1",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0042-SD.jpg?v=1746030214",
"width": 1794,
"height": 1795,
"position": 4
},
{
"id": "bb2a32ff-1f77-4481-9dcd-4b9d87ff6ab4",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0015-FR.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 5
},
{
"id": "97496d20-8041-4f60-9c55-b17e6e216cc0",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-COTTONFLEECE-RUBY-SW-ALT1.jpg?v=1746049310",
"width": 2000,
"height": 2000,
"position": 6
}
],
"price": {
"currency": "USD",
"current_value": 38,
"compare_at_value": 54
},
"vendor": "skims.com",
"first_seen_by_catalog": "2026-01-09T23:10:52.178561+00:00",
"last_updated_by_catalog": "2026-01-09T23:51:28.134254+00:00"
},
{
"id": "d481e8f3-8810-498d-856a-3c67f3b72a1e",
"url": "https://www.skims.com/products/cotton-fleece-short-onyx",
"name": "COTTON FLEECE SHORT | ONYX",
"images": [
{
"id": "c3284e88-4c53-43fb-869d-711f356102d5",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-BO-SHO-4498-ONX-2.jpg?v=1735590602",
"width": 2000,
"height": 2000,
"position": 1
},
{
"id": "737c9e6e-afcb-4a64-accc-beba6ca64271",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0010-FR_1acc4cee-2077-4508-b140-60fe1ff2de14.jpg?v=1735590602",
"width": 2000,
"height": 1997,
"position": 2
},
{
"id": "ee45e3aa-9a7c-452b-ba5c-897b88eaeb40",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0030-FR-2_912bee2a-78e7-45be-ac7d-e80db61b3401.jpg?v=1735590602",
"width": 2000,
"height": 2000,
"position": 3
},
{
"id": "508d9b8e-0247-47b7-9000-1e341adcc864",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0036-SD_11550aee-e4cd-4187-a44c-376b4149d9ef.jpg?v=1735590602",
"width": 1750,
"height": 1750,
"position": 4
},
{
"id": "4300e65c-8a6b-4240-97fc-e60414efb212",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0021-BK_ed37d0b1-d6f6-4387-9eeb-f65b45c5d078.jpg?v=1735590602",
"width": 1997,
"height": 2000,
"position": 5
},
{
"id": "efa053af-979e-4c93-91d2-72c0d31cf831",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-COTTON_FLEECE-ONX-DET-2.jpg?v=1760122731",
"width": 2000,
"height": 2000,
"position": 6
}
],
"price": {
"currency": "USD",
"current_value": 27,
"compare_at_value": 54
},
"vendor": "skims.com",
"first_seen_by_catalog": "2026-01-09T23:10:49.895871+00:00",
"last_updated_by_catalog": "2026-01-09T23:51:28.134254+00:00"
}
],
"pagination": {
"page": 1,
"page_size": 2,
"total_items": 1616,
"total_pages": 808,
"has_next": true,
"has_prev": false
},
"meta": {}
}
API Reference
Get Product Listings
Get product listings from a vendor with pagination. Optionally filter by collection URL.
GET
/
v2
/
listings
cURL
curl -X GET "https://api.getcatalog.ai/v2/listings?vendor=skims.com&page=1&page_size=2&collection_url=https://www.skims.com/collections/skims-sale" \
-H "x-api-key: $CATALOG_API_KEY"
const params = new URLSearchParams({
vendor: 'skims.com',
page: '1',
page_size: '2',
collection_url: 'https://www.skims.com/collections/skims-sale'
});
const response = await fetch(`https://api.getcatalog.ai/v2/listings?${params}`, {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} listings`);
console.log(`Page ${data.pagination.page} of ${data.pagination.total_pages}`);
import requests
response = requests.get(
'https://api.getcatalog.ai/v2/listings',
headers={'x-api-key': 'YOUR_API_KEY'},
params={
'vendor': 'skims.com',
'page': 1,
'page_size': 2,
'collection_url': 'https://www.skims.com/collections/skims-sale'
}
)
data = response.json()
print(f"Found {len(data['data'])} listings")
print(f"Page {data['pagination']['page']} of {data['pagination']['total_pages']}")
{
"data": [
{
"id": "b3fd62fe-56b3-4d24-8bb5-49485d04b4f7",
"url": "https://www.skims.com/products/cotton-fleece-short-ruby",
"name": "COTTON FLEECE SHORT | RUBY",
"images": [
{
"id": "f464d0fb-7b79-4f46-8c4a-d9f52e741787",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-SH-SHO-8419W-RBY-FLT.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 1
},
{
"id": "ae41651e-d41a-4f37-bc1b-99ae1546540f",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0001-FR.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 2
},
{
"id": "e19d3350-f474-4105-8ff5-da66503ef707",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0029-SD.jpg?v=1746030214",
"width": 1730,
"height": 1730,
"position": 3
},
{
"id": "b03ee465-81fa-46ed-bb8b-54783dfe04a1",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0042-SD.jpg?v=1746030214",
"width": 1794,
"height": 1795,
"position": 4
},
{
"id": "bb2a32ff-1f77-4481-9dcd-4b9d87ff6ab4",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0015-FR.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 5
},
{
"id": "97496d20-8041-4f60-9c55-b17e6e216cc0",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-COTTONFLEECE-RUBY-SW-ALT1.jpg?v=1746049310",
"width": 2000,
"height": 2000,
"position": 6
}
],
"price": {
"currency": "USD",
"current_value": 38,
"compare_at_value": 54
},
"vendor": "skims.com",
"first_seen_by_catalog": "2026-01-09T23:10:52.178561+00:00",
"last_updated_by_catalog": "2026-01-09T23:51:28.134254+00:00"
},
{
"id": "d481e8f3-8810-498d-856a-3c67f3b72a1e",
"url": "https://www.skims.com/products/cotton-fleece-short-onyx",
"name": "COTTON FLEECE SHORT | ONYX",
"images": [
{
"id": "c3284e88-4c53-43fb-869d-711f356102d5",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-BO-SHO-4498-ONX-2.jpg?v=1735590602",
"width": 2000,
"height": 2000,
"position": 1
},
{
"id": "737c9e6e-afcb-4a64-accc-beba6ca64271",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0010-FR_1acc4cee-2077-4508-b140-60fe1ff2de14.jpg?v=1735590602",
"width": 2000,
"height": 1997,
"position": 2
},
{
"id": "ee45e3aa-9a7c-452b-ba5c-897b88eaeb40",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0030-FR-2_912bee2a-78e7-45be-ac7d-e80db61b3401.jpg?v=1735590602",
"width": 2000,
"height": 2000,
"position": 3
},
{
"id": "508d9b8e-0247-47b7-9000-1e341adcc864",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0036-SD_11550aee-e4cd-4187-a44c-376b4149d9ef.jpg?v=1735590602",
"width": 1750,
"height": 1750,
"position": 4
},
{
"id": "4300e65c-8a6b-4240-97fc-e60414efb212",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0021-BK_ed37d0b1-d6f6-4387-9eeb-f65b45c5d078.jpg?v=1735590602",
"width": 1997,
"height": 2000,
"position": 5
},
{
"id": "efa053af-979e-4c93-91d2-72c0d31cf831",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-COTTON_FLEECE-ONX-DET-2.jpg?v=1760122731",
"width": 2000,
"height": 2000,
"position": 6
}
],
"price": {
"currency": "USD",
"current_value": 27,
"compare_at_value": 54
},
"vendor": "skims.com",
"first_seen_by_catalog": "2026-01-09T23:10:49.895871+00:00",
"last_updated_by_catalog": "2026-01-09T23:51:28.134254+00:00"
}
],
"pagination": {
"page": 1,
"page_size": 2,
"total_items": 1616,
"total_pages": 808,
"has_next": true,
"has_prev": false
},
"meta": {}
}
When to use: Browse all products from a vendor or filter by specific collections. Use with
GET /v2/collections to discover available collections first.Request
string
required
Your API key for authentication
string
required
The vendor/brand name to filter by
number
Page number for pagination (minimum: 1, default: 1)
number
Number of listings per page (minimum: 1, maximum: 100, default: 20)
string
Collection URL to filter by. If provided, only listings from this collection will be returned.URL sanitization: URLs are sanitized and normalized on the backend; client-side sanitization is not required.
Response
array
Array of listing objects
Show Listing Object
Show Listing Object
string
Unique identifier for the listing
string
Product URL
string
Product name
array
Array of product images
object
Product price information
string
Vendor/brand name
string
ISO 8601 timestamp when the product was first discovered by Catalog
string
ISO 8601 timestamp when the product was last updated by Catalog
object
object
Response metadata (currently empty for this endpoint)
cURL
curl -X GET "https://api.getcatalog.ai/v2/listings?vendor=skims.com&page=1&page_size=2&collection_url=https://www.skims.com/collections/skims-sale" \
-H "x-api-key: $CATALOG_API_KEY"
const params = new URLSearchParams({
vendor: 'skims.com',
page: '1',
page_size: '2',
collection_url: 'https://www.skims.com/collections/skims-sale'
});
const response = await fetch(`https://api.getcatalog.ai/v2/listings?${params}`, {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} listings`);
console.log(`Page ${data.pagination.page} of ${data.pagination.total_pages}`);
import requests
response = requests.get(
'https://api.getcatalog.ai/v2/listings',
headers={'x-api-key': 'YOUR_API_KEY'},
params={
'vendor': 'skims.com',
'page': 1,
'page_size': 2,
'collection_url': 'https://www.skims.com/collections/skims-sale'
}
)
data = response.json()
print(f"Found {len(data['data'])} listings")
print(f"Page {data['pagination']['page']} of {data['pagination']['total_pages']}")
{
"data": [
{
"id": "b3fd62fe-56b3-4d24-8bb5-49485d04b4f7",
"url": "https://www.skims.com/products/cotton-fleece-short-ruby",
"name": "COTTON FLEECE SHORT | RUBY",
"images": [
{
"id": "f464d0fb-7b79-4f46-8c4a-d9f52e741787",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-SH-SHO-8419W-RBY-FLT.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 1
},
{
"id": "ae41651e-d41a-4f37-bc1b-99ae1546540f",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0001-FR.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 2
},
{
"id": "e19d3350-f474-4105-8ff5-da66503ef707",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0029-SD.jpg?v=1746030214",
"width": 1730,
"height": 1730,
"position": 3
},
{
"id": "b03ee465-81fa-46ed-bb8b-54783dfe04a1",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0042-SD.jpg?v=1746030214",
"width": 1794,
"height": 1795,
"position": 4
},
{
"id": "bb2a32ff-1f77-4481-9dcd-4b9d87ff6ab4",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SH-SHO-8419W-RBY-JE-SKIMS-LOUNGEWEAR_0015-FR.jpg?v=1746030214",
"width": 2000,
"height": 2000,
"position": 5
},
{
"id": "97496d20-8041-4f60-9c55-b17e6e216cc0",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-COTTONFLEECE-RUBY-SW-ALT1.jpg?v=1746049310",
"width": 2000,
"height": 2000,
"position": 6
}
],
"price": {
"currency": "USD",
"current_value": 38,
"compare_at_value": 54
},
"vendor": "skims.com",
"first_seen_by_catalog": "2026-01-09T23:10:52.178561+00:00",
"last_updated_by_catalog": "2026-01-09T23:51:28.134254+00:00"
},
{
"id": "d481e8f3-8810-498d-856a-3c67f3b72a1e",
"url": "https://www.skims.com/products/cotton-fleece-short-onyx",
"name": "COTTON FLEECE SHORT | ONYX",
"images": [
{
"id": "c3284e88-4c53-43fb-869d-711f356102d5",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-LOUNGEWEAR-BO-SHO-4498-ONX-2.jpg?v=1735590602",
"width": 2000,
"height": 2000,
"position": 1
},
{
"id": "737c9e6e-afcb-4a64-accc-beba6ca64271",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0010-FR_1acc4cee-2077-4508-b140-60fe1ff2de14.jpg?v=1735590602",
"width": 2000,
"height": 1997,
"position": 2
},
{
"id": "ee45e3aa-9a7c-452b-ba5c-897b88eaeb40",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0030-FR-2_912bee2a-78e7-45be-ac7d-e80db61b3401.jpg?v=1735590602",
"width": 2000,
"height": 2000,
"position": 3
},
{
"id": "508d9b8e-0247-47b7-9000-1e341adcc864",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0036-SD_11550aee-e4cd-4187-a44c-376b4149d9ef.jpg?v=1735590602",
"width": 1750,
"height": 1750,
"position": 4
},
{
"id": "4300e65c-8a6b-4240-97fc-e60414efb212",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/BO-SHO-4498-ONX-MC-SKIMS-LOUNGEWEAR_0021-BK_ed37d0b1-d6f6-4387-9eeb-f65b45c5d078.jpg?v=1735590602",
"width": 1997,
"height": 2000,
"position": 5
},
{
"id": "efa053af-979e-4c93-91d2-72c0d31cf831",
"url": "https://cdn.shopify.com/s/files/1/0259/5448/4284/files/SKIMS-COTTON_FLEECE-ONX-DET-2.jpg?v=1760122731",
"width": 2000,
"height": 2000,
"position": 6
}
],
"price": {
"currency": "USD",
"current_value": 27,
"compare_at_value": 54
},
"vendor": "skims.com",
"first_seen_by_catalog": "2026-01-09T23:10:49.895871+00:00",
"last_updated_by_catalog": "2026-01-09T23:51:28.134254+00:00"
}
],
"pagination": {
"page": 1,
"page_size": 2,
"total_items": 1616,
"total_pages": 808,
"has_next": true,
"has_prev": false
},
"meta": {}
}
⌘I