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/products
List or search category-specific attributes
List or search through the attributes such as models for handbags or cases for watches.
Required attributes
attribute
string
Specifies 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.
category
string
Specifies the categories for which results are requested. Use the unique category ids separated with a comma.
Optional attributes
brand
string
Specifies the brands for which results are requested. Use the unique brand ids separated with a comma.
subcategories
string
Only 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.
search
string
Specifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
id or <category-specific attribute>
string
Specifies 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.
page
integer
Specifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_size
integer
Specifies the maximum number of results per response. Default and maximum value is 100.
start_at
date
Specifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_at
date
Specifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deleted
boolean
Filters 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/products
List or search brands
List or search through the brands available in the Trendful Catalog.
Required attributes
attribute
string
Specifies 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.
category
string
Specifies the categories for which results are requested. Use the unique category ids separated with a comma.
Optional attributes
search
string
Specifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
id
string
Specifies unique brand IDs, separated by commas, to filter results based on brand.
page
integer
Specifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_size
integer
Specifies the maximum number of results per response. Default and maximum value is 100.
start_at
date
Specifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_at
date
Specifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deleted
boolean
Filters 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/products
List or search categories
List or search through the categories available in the Trendful Catalog.
Required attributes
attribute
string
Specifies 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
search
string
Specifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
id
string
Specifies unique category IDs, separated by commas, to filter results based on category.
page
integer
Specifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_size
integer
Specifies the maximum number of results per response. Default and maximum value is 100.
start_at
date
Specifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_at
date
Specifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deleted
boolean
Filters 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/products
List or search products
List or search products.
Required attributes
attribute
string
Specifies 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.
category
string
Specifies the categories for which results are requested. Use the unique category ids separated with a comma.
Optional attributes
brand
string
Specifies the brands for which results are requested. Use the unique brand ids separated with a comma.
search
string
Specifies the search string for semantic search filtering. Smart search allows for misspellings while finding relevant results.
<category-specific attribute>
string
Specifies 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.
id
string
Specifies unique product IDs, separated by commas, to filter results based on product.
page
integer
Specifies the page number of results to return. Default is 0. Total pages are provided in the initial API response with 'totalPages'.
page_size
integer
Specifies the maximum number of results per response. Default and maximum value is 100.
start_at
date
Specifies the start date (YYYY-MM-DD) for filtering results based on their update date.
end_at
date
Specifies the end date (YYYY-MM-DD) for filtering results based on their update date.
deleted
boolean
Filters 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-vision
Trendful Vision
Find products by image recognition.
Required attributes
url
string
The URL where the image is publicly accessible. Must be in jpeg, jpg, or png format. Either `url` or `base64` is required.
base64
string
Base64 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.
![App screenshot](/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fscreenshot-admin.3692e432.png&w=3840&q=75)