An API to enhance product discovery and reselling
Discover and search thousands of designer handbags and watches with our powerful Catalog API, providing pricing insights and detailed product data including names, images, and popularity trends.
Our Catalog API provides comprehensive access to a diverse index of approximately 70,000 products, encompassing handbags, watches, and accessories. During your app's development phase, enjoy complimentary access to approximately 5,000 products.
The Catalog API empowers you to enhance product discovery through intelligent search capabilities and advanced filters. Beyond delivering a seamless user search experience, it furnishes data on popularity, images, market estimates, and more.
Fair market value estimates are automatically generated for products across varying conditions.
Getting Started
Obtaining an API Key
The API is only available for Enterprise plans. You can get an Enterprise plan and an API key by contacting contact@trendful.com.
Sending your first API call
There are four properties that you must include in every API call.
- Bearer token: A 20-character alpha-numeric string that gives you access to use the API. This is your API Key.
- Method: An action you can perform on a resource.
- Query: An optional key-value pairs used to filter the API response.
Understanding API responses
All API calls will return JSON with success, data, and eventually other properties such as page or totalPages. Exceptions to this will be specified in the documentation.
Response
{
"success": true,
"data": {},
"page_results": 100,
"total_results": 627,
"page": 0,
"total_pages": 7,
"stats": {}
}Response
{
"success": false,
"error": "Something went wrong."
}Documentation
POST/v2/productsList or search category-specific attributes
List or search through the attributes such as models for handbags or cases for watches.
Required attributes
attributestringSpecifies the attribute for which results are requested. Use 'category' to list categories; each category has specific attributes. Default is 'product' for a list of products.
categorystringSpecifies the categories for which results are requested. Use the unique category ids separated with a comma.
Optional attributes
brandstringSpecifies the brands for which results are requested. Use the unique brand ids separated with a comma.
subcategoriesstringOnly works for model attribute, specifies the subcategories of handbags (for example shoulder,tote) for which results are requested. Use the unique subcategory ids separated with a comma.
searchstringSpecifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
id or <category-specific attribute>stringSpecifies unique attribute IDs, separated by commas, to filter results based on the requested attribute. To filter handbags by models when 'attribute' is style, use 'model' and the unique model IDs separated by commas. To filter watches by cases when 'attribute' is dial, use 'case' and the unique case IDs separated by commas.
pageintegerSpecifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_sizeintegerSpecifies the maximum number of results per response. Default and maximum value is 100.
start_atdateSpecifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_atdateSpecifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deletedbooleanFilters out deleted entries. Default is false, excluding deleted entries.
Request
curl https://api.trendful.com/v2/products \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"category": "handbags",
"search": "Neverfull",
"attribute": "model",
"page_size": 3,
"subcategories": "tote,shoulder"
}'
Response
{
"success": true,
"data": [
{
"id": "model_S2mZyGgh6nWioh3ayDp8h4",
"popularity": 317,
"images": [
"https://trendful-api-images.s3.amazonaws.com/variant_FqD6XkuWrhtBNWZ3hqnY73_0.jpg"
],
"thumbnails": [
"https://trendful-api-images.s3.amazonaws.com/variant_FqD6XkuWrhtBNWZ3hqnY73_160x160_0.jpg"
],
"market_estimates": [
{
"max": 3300,
"estimated_at": null,
"currency": "usd"
}
],
"subcategories": [
"tote"
],
"deleted": false,
"category_name": "Handbags",
"brand_name": "Louis Vuitton",
"brand_id": "brand_9YJxjSHS5UK1jFmA2dThev",
"updated_at": "2023-11-07T21:27:50.905Z",
"category_id": "handbags",
"name": "Neverfull Tote"
},
{
"id": "model_K4FqoTF6GDnQSdGPcnMfoh",
"popularity": 231,
"images": [
"https://trendful-api-images.s3.amazonaws.com/variant_9FfvQg3M5GEJ6aiLXXGL13_0.jpg"
],
"thumbnails": [
"https://trendful-api-images.s3.amazonaws.com/variant_9FfvQg3M5GEJ6aiLXXGL13_160x160_0.jpg"
],
"market_estimates": [
{
"max": 3790,
"estimated_at": null,
"currency": "usd"
}
],
"subcategories": [
"tote"
],
"deleted": false,
"category_name": "Handbags",
"brand_name": "Louis Vuitton",
"brand_id": "brand_9YJxjSHS5UK1jFmA2dThev",
"updated_at": "2023-11-07T21:27:34.838Z",
"category_id": "handbags",
"name": "Neverfull NM Tote"
}
],
"search": "Neverfull",
"results": 2,
"total_results": 2,
"page": 0,
"total_pages": 1,
"stats": {
"id": {
"model_K4FqoTF6GDnQSdGPcnMfoh": 1,
"model_S2mZyGgh6nWioh3ayDp8h4": 1
},
"index": {
"model": 2
},
"deleted": {
"false": 2
},
"brand_id": {
"brand_9YJxjSHS5UK1jFmA2dThev": 2
},
"category_id": {
"handbags": 2
},
"subcategories": {
"tote": 2
},
"updated_at__timestamp": {
"1699392454838": 1,
"1699392470905": 1
}
}
}POST/v2/productsList or search brands
List or search through the brands available in the Trendful Catalog.
Required attributes
attributestringSpecifies the attribute for which results are requested. Use 'category' to list categories; each category has specific attributes. Default is 'product' for a list of products.
categorystringSpecifies the categories for which results are requested. Use the unique category ids separated with a comma.
Optional attributes
searchstringSpecifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
idstringSpecifies unique brand IDs, separated by commas, to filter results based on brand.
pageintegerSpecifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_sizeintegerSpecifies the maximum number of results per response. Default and maximum value is 100.
start_atdateSpecifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_atdateSpecifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deletedbooleanFilters out deleted entries. Default is false, excluding deleted entries.
Request
curl https://api.trendful.com/v2/products \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"category": "handbags,accessories",
"brand": "brand_9YJxjSHS5UK1jFmA2dThev,brand_p9zYU9yn94qkXHik9ozbP",
"attribute": "brand",
"page_size": 10
}'
Response
{
"success": true,
"data": [
{
"id": "brand_9YJxjSHS5UK1jFmA2dThev",
"popularity": 42,
"market_estimates": [
{
"max": 8545,
"estimated_at": null,
"currency": "usd"
}
],
"deleted": false,
"category_name": "Handbags",
"updated_at": "2023-03-02T16:05:42.722Z",
"category_id": "handbags",
"name": "Louis Vuitton"
},
{
"id": "brand_p9zYU9yn94qkXHik9ozbP",
"popularity": 41,
"market_estimates": [
{
"max": 16445,
"estimated_at": null,
"currency": "usd"
}
],
"deleted": false,
"category_name": "Handbags",
"updated_at": "2023-03-02T16:05:44.141Z",
"category_id": "handbags",
"name": "Chanel"
}
],
"search": "",
"results": 2,
"total_results": 2,
"page": 0,
"total_pages": 1,
"stats": {
"id": {
"brand_9YJxjSHS5UK1jFmA2dThev": 1,
"brand_p9zYU9yn94qkXHik9ozbP": 1
},
"index": {
"brand": 2
},
"deleted": {
"false": 2
},
"category_id": {
"handbags": 2
},
"updated_at__timestamp": {
"1677773142722": 1,
"1677773144141": 1
}
}
}POST/v2/productsList or search categories
List or search through the categories available in the Trendful Catalog.
Required attributes
attributestringSpecifies the attribute for which results are requested. Use 'category' to list categories; each category has specific attributes. Default is 'product' for a list of products.
Optional attributes
searchstringSpecifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
idstringSpecifies unique category IDs, separated by commas, to filter results based on category.
pageintegerSpecifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_sizeintegerSpecifies the maximum number of results per response. Default and maximum value is 100.
start_atdateSpecifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_atdateSpecifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deletedbooleanFilters out deleted entries. Default is false, excluding deleted entries.
Request
curl https://api.trendful.com/v2/products \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"attribute": "category",
"page_size": 10
}'
Response
{
"success": true,
"data": [
{
"id": "watches",
"deleted": false,
"updated_at": "2023-03-02T15:52:25.199Z",
"accessories": [
"Receipt",
"Authenticity card",
"Warranty card/papers",
"Original box",
"Extra links"
],
"name": "Watches",
"attributes": [
"category",
"brand",
"family",
"case",
"dial",
"product"
],
"variants": [
"reference"
]
},
{
"id": "handbags",
"deleted": false,
"updated_at": "2023-03-02T15:52:24.937Z",
"accessories": [
"Receipt",
"Dust bag",
"Authenticity card",
"Care cards",
"Original box",
"Shoulder strap",
"Pochette"
],
"name": "Handbags",
"attributes": [
"category",
"brand",
"model",
"style",
"product"
],
"variants": [
"size"
]
}
],
"search": "",
"results": 2,
"total_results": 2,
"page": 0,
"total_pages": 1,
"stats": {
"id": {
"handbags": 1,
"watches": 1
},
"index": {
"category": 2
},
"deleted": {
"false": 2
},
"updated_at__timestamp": {
"1677772344937": 1,
"1677772345199": 1
}
}
}POST/v2/productsList or search products
List or search products.
Required attributes
attributestringSpecifies the attribute for which results are requested. Use 'category' to list categories; each category has specific attributes. Default is 'product' for a list of products.
categorystringSpecifies the categories for which results are requested. Use the unique category ids separated with a comma.
Optional attributes
brandstringSpecifies the brands for which results are requested. Use the unique brand ids separated with a comma.
searchstringSpecifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
<category-specific attribute>stringSpecifies unique attribute IDs, separated by commas, to filter results based on the requested attribute. To filter handbags by models, use 'model' and the unique model IDs separated by commas. To filter watches by cases, use 'case' and the unique case IDs separated by commas.
idstringSpecifies unique product IDs, separated by commas, to filter results based on product.
pageintegerSpecifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_sizeintegerSpecifies the maximum number of results per response. Default and maximum value is 100.
start_atdateSpecifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_atdateSpecifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deletedbooleanFilters out deleted entries. Default is false, excluding deleted entries.
Request
curl https://api.trendful.com/v2/products \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"search": "Louis Vuitton Neverfull Tote",
"attribute": "product",
"page_size": 2,
"start_at": "2022-01-19",
"end_at": "2023-12-20"
}'
Response
{
"success": true,
"data": [
{
"id": "product_wvnuGXhFwIdTr0uaTc8NEzCSLTHrwS0mS8et",
"popularity": 317,
"deleted": false,
"updated_at": "2023-11-10T17:59:39.244Z",
"category_id": "handbags",
"attributes": [
{
"field": "category",
"name": "Handbags",
"id": "handbags",
"code": "HB"
},
{
"field": "brand",
"name": "Louis Vuitton",
"id": "brand_9YJxjSHS5UK1jFmA2dThev",
"code": "LV"
},
{
"field": "model",
"name": "Neverfull Tote",
"id": "model_S2mZyGgh6nWioh3ayDp8h4",
"code": "NV"
},
{
"field": "style",
"name": "Damier",
"id": "style_2RP5szV77KDXGFFrb6QubL",
"code": "DR"
}
],
"variants": [
{
"historical_estimates": [
{
"region": "EU-IE",
"url": "https://trendful-data.s3.amazonaws.com/pricer/EU-IE/historical_estimates/variant_zKUyfo87qBSLijNLFKys3.csv"
},
{
"region": "NA",
"url": "https://trendful-data.s3.amazonaws.com/pricer/NA/historical_estimates/variant_zKUyfo87qBSLijNLFKys3.csv"
}
],
"pricing_data": [
{
"region": "EU-IE",
"url": "https://trendful-data.s3.amazonaws.com/pricer/EU-IE/pricing_data/variant_zKUyfo87qBSLijNLFKys3.csv"
},
{
"region": "NA",
"url": "https://trendful-data.s3.amazonaws.com/pricer/NA/pricing_data/variant_zKUyfo87qBSLijNLFKys3.csv"
}
],
"market_estimates": [
{
"estimated_at": "2023-11-02T00:59:01.000Z",
"source": "google_shopping",
"currency": "eur",
"region": "EU-IE",
"A": 1385,
"D": 1095,
"C": 1240,
"B": 1335
},
{
"estimated_at": "2023-05-03T18:22:04.000Z",
"source": "etsy",
"currency": "eur",
"region": "EU-IE",
"A": 1580,
"D": 1340,
"C": 1420,
"B": 1500
},
{
"estimated_at": "2023-03-30T00:52:00.000Z",
"source": "farfetch",
"currency": "eur",
"region": "EU-IE",
"A": 2455,
"D": 2190,
"C": 2275,
"B": 2365
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "the_realreal",
"currency": "usd",
"region": "NA",
"A": 1525,
"D": 1295,
"C": 1370,
"B": 1445
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "google_shopping",
"currency": "usd",
"region": "NA",
"A": 1480,
"D": 1140,
"C": 1305,
"B": 1395
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "fashionphile",
"currency": "usd",
"region": "NA",
"A": 1685,
"D": 1385,
"C": 1510,
"B": 1595
},
{
"estimated_at": "2023-10-30T23:46:02.000Z",
"source": "rebag",
"currency": "usd",
"region": "NA",
"A": 1860,
"D": 1170,
"C": 1545,
"B": 1705
},
{
"estimated_at": "2023-10-30T23:46:02.000Z",
"source": "ebay",
"currency": "usd",
"region": "NA",
"A": 1755,
"D": 1120,
"C": 1270,
"B": 1555
},
{
"estimated_at": "2023-10-30T23:46:02.000Z",
"source": "poshmark",
"currency": "usd",
"region": "NA",
"A": 1885,
"D": 1160,
"C": 1255,
"B": 1610
},
{
"estimated_at": "2023-10-30T23:46:02.000Z",
"source": "farfetch",
"currency": "usd",
"region": "NA",
"A": 1845,
"D": 1580,
"C": 1665,
"B": 1755
},
{
"estimated_at": "2023-10-30T23:46:02.000Z",
"source": "stockx",
"currency": "usd",
"region": "NA",
"A": 2075,
"D": 1780,
"C": 1945,
"B": 2045
},
{
"estimated_at": "2023-05-08T21:58:23.000Z",
"source": "etsy",
"currency": "usd",
"region": "NA",
"A": 2230,
"D": 1400,
"C": 1415,
"B": 1980
},
{
"estimated_at": "2023-03-07T02:48:25.000Z",
"source": "vestiaire_collective",
"currency": "usd",
"region": "NA",
"A": 2100,
"D": 1530,
"C": 1545,
"B": 1735
},
{
"estimated_at": "2023-03-07T02:48:25.000Z",
"source": "what_goes_around_come_around",
"currency": "usd",
"region": "NA",
"A": 1895,
"D": 1705,
"C": 1770,
"B": 1830
}
],
"id": "variant_zKUyfo87qBSLijNLFKys3",
"thumbnails": [
"https://trendful-api-images.s3.amazonaws.com/variant_zKUyfo87qBSLijNLFKys3_160x160_0.jpg"
],
"fields": [
{
"field": "size",
"name": "GM",
"code": "GM"
}
],
"images": [
"https://trendful-api-images.s3.amazonaws.com/variant_zKUyfo87qBSLijNLFKys3_0.jpg"
],
"popularity": 105
},
{
"historical_estimates": [
{
"region": "EU-IE",
"url": "https://trendful-data.s3.amazonaws.com/pricer/EU-IE/historical_estimates/variant_FqD6XkuWrhtBNWZ3hqnY73.csv"
},
{
"region": "NA",
"url": "https://trendful-data.s3.amazonaws.com/pricer/NA/historical_estimates/variant_FqD6XkuWrhtBNWZ3hqnY73.csv"
}
],
"pricing_data": [
{
"region": "EU-IE",
"url": "https://trendful-data.s3.amazonaws.com/pricer/EU-IE/pricing_data/variant_FqD6XkuWrhtBNWZ3hqnY73.csv"
},
{
"region": "NA",
"url": "https://trendful-data.s3.amazonaws.com/pricer/NA/pricing_data/variant_FqD6XkuWrhtBNWZ3hqnY73.csv"
}
],
"market_estimates": [
{
"estimated_at": "2023-11-02T00:59:00.000Z",
"source": "google_shopping",
"currency": "eur",
"region": "EU-IE",
"A": 1470,
"D": 975,
"C": 1210,
"B": 1340
},
{
"estimated_at": "2023-11-02T00:59:00.000Z",
"source": "joli_closet",
"currency": "eur",
"region": "EU-IE",
"A": 2870,
"D": 535,
"C": 1240,
"B": 1935
},
{
"estimated_at": "2023-11-02T00:59:00.000Z",
"source": "farfetch",
"currency": "eur",
"region": "EU-IE",
"A": 5970,
"D": 1490,
"C": 1760,
"B": 2375
},
{
"estimated_at": "2023-11-02T00:59:00.000Z",
"source": "stockx",
"currency": "eur",
"region": "EU-IE",
"A": 5060,
"D": 1365,
"C": 1885,
"B": 3280
},
{
"estimated_at": "2023-11-02T00:59:00.000Z",
"source": "hewi",
"currency": "eur",
"region": "EU-IE",
"A": 1235,
"D": 450,
"C": 470,
"B": 515
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "the_realreal",
"currency": "usd",
"region": "NA",
"A": 1495,
"D": 1275,
"C": 1350,
"B": 1420
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "google_shopping",
"currency": "usd",
"region": "NA",
"A": 1430,
"D": 1050,
"C": 1215,
"B": 1335
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "fashionphile",
"currency": "usd",
"region": "NA",
"A": 1890,
"D": 1100,
"C": 1305,
"B": 1560
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "rebag",
"currency": "usd",
"region": "NA",
"A": 1830,
"D": 1220,
"C": 1450,
"B": 1605
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "ebay",
"currency": "usd",
"region": "NA",
"A": 1720,
"D": 915,
"C": 1030,
"B": 1415
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "poshmark",
"currency": "usd",
"region": "NA",
"A": 1820,
"D": 925,
"C": 1105,
"B": 1435
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "stockx",
"currency": "usd",
"region": "NA",
"A": 2175,
"D": 1875,
"C": 1955,
"B": 2050
},
{
"estimated_at": "2023-10-30T23:46:00.000Z",
"source": "hewi",
"currency": "usd",
"region": "NA",
"A": 1815,
"D": 1740,
"C": 1760,
"B": 1785
},
{
"estimated_at": "2023-07-25T01:52:26.000Z",
"source": "yoogis_closet",
"currency": "usd",
"region": "NA",
"A": 1395,
"D": 1095,
"C": 1195,
"B": 1295
},
{
"estimated_at": "2023-03-07T02:48:24.000Z",
"source": "vestiaire_collective",
"currency": "usd",
"region": "NA",
"A": 1895,
"D": 990,
"C": 1510,
"B": 1640
}
],
"id": "variant_FqD6XkuWrhtBNWZ3hqnY73",
"thumbnails": [
"https://trendful-api-images.s3.amazonaws.com/variant_FqD6XkuWrhtBNWZ3hqnY73_160x160_0.jpg"
],
"fields": [
{
"field": "size",
"name": "MM",
"code": "MM"
}
],
"images": [
"https://trendful-api-images.s3.amazonaws.com/variant_FqD6XkuWrhtBNWZ3hqnY73_0.jpg"
],
"popularity": 317
},
{
"historical_estimates": [
{
"region": "EU-IE",
"url": "https://trendful-data.s3.amazonaws.com/pricer/EU-IE/historical_estimates/variant_LMqxmVHi6Sgw5qRiyZb2mN.csv"
},
{
"region": "NA",
"url": "https://trendful-data.s3.amazonaws.com/pricer/NA/historical_estimates/variant_LMqxmVHi6Sgw5qRiyZb2mN.csv"
}
],
"pricing_data": [
{
"region": "EU-IE",
"url": "https://trendful-data.s3.amazonaws.com/pricer/EU-IE/pricing_data/variant_LMqxmVHi6Sgw5qRiyZb2mN.csv"
},
{
"region": "NA",
"url": "https://trendful-data.s3.amazonaws.com/pricer/NA/pricing_data/variant_LMqxmVHi6Sgw5qRiyZb2mN.csv"
}
],
"market_estimates": [
{
"estimated_at": "2023-11-02T00:59:01.000Z",
"source": "google_shopping",
"currency": "eur",
"region": "EU-IE",
"A": 1315,
"D": 945,
"C": 1070,
"B": 1170
},
{
"estimated_at": "2023-11-02T00:59:01.000Z",
"source": "joli_closet",
"currency": "eur",
"region": "EU-IE",
"A": 1445,
"D": 670,
"C": 1025,
"B": 1225
},
{
"estimated_at": "2023-11-02T00:59:01.000Z",
"source": "farfetch",
"currency": "eur",
"region": "EU-IE",
"A": 3180,
"D": 1305,
"C": 1470,
"B": 1570
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "the_realreal",
"currency": "usd",
"region": "NA",
"A": 1515,
"D": 1290,
"C": 1365,
"B": 1440
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "google_shopping",
"currency": "usd",
"region": "NA",
"A": 1475,
"D": 1105,
"C": 1230,
"B": 1345
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "fashionphile",
"currency": "usd",
"region": "NA",
"A": 1650,
"D": 1120,
"C": 1250,
"B": 1420
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "rebag",
"currency": "usd",
"region": "NA",
"A": 1935,
"D": 1200,
"C": 1410,
"B": 1640
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "ebay",
"currency": "usd",
"region": "NA",
"A": 1725,
"D": 1055,
"C": 1215,
"B": 1425
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "poshmark",
"currency": "usd",
"region": "NA",
"A": 1800,
"D": 1070,
"C": 1340,
"B": 1545
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "what_goes_around_come_around",
"currency": "usd",
"region": "NA",
"A": 1750,
"D": 1695,
"C": 1715,
"B": 1730
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "farfetch",
"currency": "usd",
"region": "NA",
"A": 1870,
"D": 1245,
"C": 1540,
"B": 1655
},
{
"estimated_at": "2023-10-30T23:46:01.000Z",
"source": "stockx",
"currency": "usd",
"region": "NA",
"A": 1975,
"D": 1900,
"C": 1925,
"B": 1950
},
{
"estimated_at": "2023-06-13T05:08:46.000Z",
"source": "etsy",
"currency": "usd",
"region": "NA",
"A": 1490,
"D": 1475,
"C": 1480,
"B": 1485
},
{
"estimated_at": "2023-03-07T02:48:25.000Z",
"source": "vestiaire_collective",
"currency": "usd",
"region": "NA",
"A": 1740,
"D": 860,
"C": 1075,
"B": 1390
}
],
"id": "variant_LMqxmVHi6Sgw5qRiyZb2mN",
"thumbnails": [
"https://trendful-api-images.s3.amazonaws.com/variant_LMqxmVHi6Sgw5qRiyZb2mN_160x160_0.jpg"
],
"fields": [
{
"field": "size",
"name": "PM",
"code": "PM"
}
],
"images": [
"https://trendful-api-images.s3.amazonaws.com/variant_LMqxmVHi6Sgw5qRiyZb2mN_0.jpg"
],
"popularity": 131
}
]
}
],
"search": "\"Louis Vuitton Neverfull Tote\"",
"results": 2,
"total_results": 11,
"page": 0,
"total_pages": 6,
"stats": {
"id": {
"product_0EfnMR2PXTTHqxHbYyt5DN1foJQKzge3mB3E": 1,
"product_1LkUxmr8ne1vnxah12b3TS1Tgvisa6RAQwU4": 1,
"product_K3gB1X8DYYzTSxkSSsTHuslbizEJR3oL7Ddt": 1,
"product_Yz2UJ5dlrPo85aBQGdlaq2GCVBUXzyBcyNbA": 1,
"product_ZqUsYioUTxgmOxDE8trITrGDweHy1S1y7WoC": 1,
"product_e0k8DYwhP7hsRaQCDYmH8hH9jQA2mi4YwiFV": 1,
"product_fTyUIzm6UUyuxnNvJaWpPBdJ5hazXKOdZNa9": 1,
"product_jPdmJCclrdNznEZSdkD685uAFgbqMXQpSPS3": 1,
"product_s7mdOuWvLo4JHpNS6GzqzrzUjOwBMVFEvQf1": 1,
"product_sVVHkQHWH4w1QbynuKIOMb3m6tiJ10FpyQXN": 1,
"product_wvnuGXhFwIdTr0uaTc8NEzCSLTHrwS0mS8et": 1
},
"index": {
"product": 11
},
"deleted": {
"false": 11
},
"category_id": {
"handbags": 11
},
"variants.id": {
"variant_2Pdtk3A7ymbrUsfXUhRYS2": 1,
"variant_2o56YeXeTcx4B9i3dvNVJd": 1,
"variant_9CECUMiNL3ViaWPZcjXtRw": 1,
"variant_9FfvQg3M5GEJ6aiLXXGL13": 1,
"variant_9M32ZSKkfZ1vnQJVjYYGyR": 1,
"variant_AdiRCm5ZsWcNpEtfzkMYep": 1,
"variant_DxJC1qseL4EiA9mCKqR3LS": 1,
"variant_Ffy8WkSVMc3BbReyzrcjwS": 1,
"variant_FqD6XkuWrhtBNWZ3hqnY73": 1,
"variant_GUCnMjkcJPD3ncwUt4n6wG": 1,
"variant_LMqxmVHi6Sgw5qRiyZb2mN": 1,
"variant_LjPjsBQHBaqusZjtqTXN9G": 1,
"variant_N47EYeZS2RxLD8Eo4XNkj4": 1,
"variant_S1SLBeG5m3mLrPxey17ioZ": 1,
"variant_SFTdrmErZ9t3zNQR3mGV4m": 1,
"variant_TmUVkp97FqWJ3jNAEvjfb3": 1,
"variant_V8RWA7d5nnHtqbVwudYp15": 1,
"variant_VBrZXejeHdJGRbBrVPBnhA": 1,
"variant_WW3cRKCMoxsn11NRxz2URo": 1,
"variant_YbNM2fXdnDsxefe6WZ7qJM": 1,
"variant_zKUyfo87qBSLijNLFKys3": 1
},
"attributes.id": {
"brand_9YJxjSHS5UK1jFmA2dThev": 11,
"handbags": 11,
"model_S2mZyGgh6nWioh3ayDp8h4": 9,
"model_K4FqoTF6GDnQSdGPcnMfoh": 2,
"style_2RP5szV77KDXGFFrb6QubL": 1,
"style_4JqRTGGWaVSR7gmVPtPJWT": 1,
"style_CMsk3eHeWubeGN3i4m7ThN": 1,
"style_E2gYbYms2bcTGMz9Sbdj6x": 1,
"style_EQHbCy2yLgua5obVhTu9eA": 1,
"style_J4VqzwyHu94DPqnBDkD423": 1,
"style_KWq6UMuGTSExs5XLLd3UBv": 1,
"style_Q6Yea495FZsyjPGJ1aE959": 1,
"style_Q9vPKzApkRf2v8qSSb98sD": 1,
"style_Sc18JMW8cpML1nCZ12wjcj": 1,
"style_Xgmrwb8PaCeuCeWFLbXhew": 1
},
"updated_at__timestamp": {
"1667850514344": 1,
"1667850522142": 1,
"1699639095923": 1,
"1699639097318": 1,
"1699639123900": 1,
"1699639146421": 1,
"1699639151899": 1,
"1699639159694": 1,
"1699639173256": 1,
"1699639173501": 1,
"1699639179244": 1
}
}
}POST/v2/trendful-visionTrendful Vision
Find products by image recognition.
Required attributes
urlstringThe URL where the image is publicly accessible. Must be in jpeg, jpg, or png format. Either `url` or `base64` is required.
base64stringBase64 encoded image data. If both `url` and `base64` are provided, `url` will be used.
Request
curl https://api.trendful.com/v2/trendful-vision
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"url": "https://trendful-api-images.s3.amazonaws.com/variant_CuySSwRV8mYzYRsAqSLiXi_0.jpg"
}'
Response
{
"success": true,
"results": [
{
"label": "product_XoZWZ6ySBFitYdqAe6rjOZSwmW0f6fb9IkAw",
"confidence": 0.232308239,
"id": "7625348708992811008",
"product": {
"id": "product_XoZWZ6ySBFitYdqAe6rjOZSwmW0f6fb9IkAw",
"popularity": 177,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "VNCS",
"field": "model",
"name": "Vintage Classic Single Flap Bag",
"id": "model_3ZkDqw6jeoMggnNTCk9Lyg"
},
{
"code": "QULA",
"field": "style",
"name": "Quilted Lambskin",
"id": "style_9d5QwG1nTBFDdctm4wYi62"
}
],
"variants": []
}
},
{
"label": "product_zsw6Rwf6pgUgdvtWatdt1dKCHZ8htEE2XfUM",
"confidence": 0.0591893531,
"id": "7648992607036506112",
"product": {
"id": "product_zsw6Rwf6pgUgdvtWatdt1dKCHZ8htEE2XfUM",
"popularity": 125,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "CDFL",
"field": "model",
"name": "Classic Double Flap Bag",
"id": "model_UmU8eLFE4CzASKuE9aHDnW"
},
{
"code": "QULA",
"field": "style",
"name": "Quilted Lambskin",
"id": "style_B2246vhrQ2brLDUUqdJoZa"
}
],
"variants": []
}
},
{
"label": "product_rzRYApBMmtUi2don40hH9bVv4FB8RKLSplAq",
"confidence": 0.0497691669,
"id": "6731384182959767552",
"product": {
"id": "product_rzRYApBMmtUi2don40hH9bVv4FB8RKLSplAq",
"popularity": 64,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "VIDF",
"field": "model",
"name": "Vintage Diana Flap Bag",
"id": "model_4CHgrnVrxfMd7W36SGf21s"
},
{
"code": "QULA",
"field": "style",
"name": "Quilted Lambskin",
"id": "style_LJ5DP6QqsdaJmoBtWHvBpb"
}
],
"variants": []
}
},
{
"label": "product_kkqVhrl096Ry8s0HNeZ5BNRm4X1G8TmU47Qa",
"confidence": 0.0254885089,
"id": "4463821770578722816",
"product": {
"id": "product_kkqVhrl096Ry8s0HNeZ5BNRm4X1G8TmU47Qa",
"popularity": 44,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "CSF",
"field": "model",
"name": "Classic Single Flap Bag",
"id": "model_H5ihnwjPuhqvKJrG8DHwXV"
},
{
"code": "QULA",
"field": "style",
"name": "Quilted Lambskin",
"id": "style_Rqn393uGetwKSMr4o2QfrE"
}
],
"variants": []
}
},
{
"label": "product_O4LI6sB01Y4Weq04OW1CE7XZLIxNVUwy2TyR",
"confidence": 0.0237635449,
"id": "8273867055334162432",
"product": {
"id": "product_O4LI6sB01Y4Weq04OW1CE7XZLIxNVUwy2TyR",
"popularity": 37,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "R255",
"field": "model",
"name": "Reissue 2.55 Flap Bag",
"id": "model_4diYegodn23GFmg6GLtja5"
},
{
"code": "QAC",
"field": "style",
"name": "Quilted Aged Calfskin",
"id": "style_NWNVFwLQte3ZhZ9Put6u2d"
}
],
"variants": []
}
},
{
"label": "product_PoELmI2NomVeRAOiNAHUELaiUFGek67gDEBl",
"confidence": 0.0219516791,
"id": "7929341683840319488",
"product": {
"id": "product_PoELmI2NomVeRAOiNAHUELaiUFGek67gDEBl",
"popularity": 171,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "CDFL",
"field": "model",
"name": "Classic Double Flap Bag",
"id": "model_UmU8eLFE4CzASKuE9aHDnW"
},
{
"code": "QCA",
"field": "style",
"name": "Quilted Caviar",
"id": "style_W1H6bz8TzXjtTMZdQa4UeT"
}
],
"variants": []
}
},
{
"label": "product_DS3HB4GO1YdULx5TB12jW93Yuw4ROcub47kO",
"confidence": 0.0168566704,
"id": "6274268820781662208",
"product": {
"id": "product_DS3HB4GO1YdULx5TB12jW93Yuw4ROcub47kO",
"popularity": 367,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "VCDFFL",
"field": "model",
"name": "Vintage Classic Double Flap Bag",
"id": "model_MPGzq9hcDJ4nnrHBTqB1qM"
},
{
"code": "QULA",
"field": "style",
"name": "Quilted Lambskin",
"id": "style_9snAUBFnRyWkc8F7SQsFe1"
}
],
"variants": []
}
},
{
"label": "product_swZ8BQbAlwZRFWDIhbpRSKNrxflP1lukCTHY",
"confidence": 0.0119937286,
"id": "1262888335425142784",
"product": {
"id": "product_swZ8BQbAlwZRFWDIhbpRSKNrxflP1lukCTHY",
"popularity": 22,
"category_id": "handbags",
"attributes": [
{
"code": "HB",
"field": "category",
"name": "Handbags",
"id": "handbags"
},
{
"code": "CH",
"field": "brand",
"name": "Chanel",
"id": "brand_p9zYU9yn94qkXHik9ozbP"
},
{
"code": "VIFF",
"field": "model",
"name": "Vintage Full Flap Bag",
"id": "model_GvUQfM3vL9dpDqc2oZzvLU"
},
{
"code": "QULA",
"field": "style",
"name": "Quilted Lambskin",
"id": "style_Ktc4ZLCbCrJnJduJjfTgaU"
}
],
"variants": []
}
}
],
"processingTime": 4305,
"predictionId": "prediction_GYBOinnglaJTULJ6rgfU"
}Boost your productivity.
Deploy Trendful on your store today.
An integrated suite of tools with all the recommerce features your business needs to start, run and scale.
