Products
Orders
curl --request GET \
--url https://api.snappy.com/v3/products/export \
--header 'X-Api-Key: <api-key>'{
"data": [
{
"id": "a1b2c3d4e5",
"title": "Iphone 17 Pro Max",
"createdAt": "2026-01-15T10:30:00Z",
"media": [
{
"type": "image",
"src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
}
],
"category": {
"fullName": "gifts / electronics / iphones"
},
"catalog": "marketplace",
"types": [
"physical"
],
"variantsCount": 123,
"brand": {
"id": "621f9d4b1e675adcbc196159",
"name": "Apple",
"description": "Cute pet brand"
},
"tags": [
{
"id": "t1",
"name": "Popular"
}
],
"priceRange": {
"min": {
"amount": 10,
"currency": "usd"
},
"max": {
"amount": 10,
"currency": "usd"
}
}
}
]
}Export products (synchronous)
Synchronously exports all products matching the query. Internally paginates through every match and returns the full set in a single response.
Content negotiation via Accept:
application/json— returns{ data: Product[] }(no pagination fields; the export already returns every matching product).text/csv— returns a CSV stream (RFC 4180, UTF-8,\r\n).
CSV columns:
- Base columns (always present):
id,title,createdAt,category,types,media. - When
includeincludesbrand: addbrandId,brandName. - When
includeincludestags: addtags(semicolon-delimited).
Streaming and headers (Accept: application/json):
Content-Type: application/json; charset=utf-8Transfer-Encoding: chunkedwhen streamedContent-Encoding: gzip|br|zstd|deflatewhen negotiated viaAccept-EncodingCache-Control: no-store
Streaming and headers (Accept: text/csv):
Content-Type: text/csv; charset=utf-8Content-Disposition: attachment; filename="collection_{collectionId}.csv"whencollectionIdis provided
Subject to a response size limit; for larger result sets, use the
asynchronous export endpoint (POST /v3/products/exports).
curl --request GET \
--url https://api.snappy.com/v3/products/export \
--header 'X-Api-Key: <api-key>'{
"data": [
{
"id": "a1b2c3d4e5",
"title": "Iphone 17 Pro Max",
"createdAt": "2026-01-15T10:30:00Z",
"media": [
{
"type": "image",
"src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
}
],
"category": {
"fullName": "gifts / electronics / iphones"
},
"catalog": "marketplace",
"types": [
"physical"
],
"variantsCount": 123,
"brand": {
"id": "621f9d4b1e675adcbc196159",
"name": "Apple",
"description": "Cute pet brand"
},
"tags": [
{
"id": "t1",
"name": "Popular"
}
],
"priceRange": {
"min": {
"amount": 10,
"currency": "usd"
},
"max": {
"amount": 10,
"currency": "usd"
}
}
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.snappy.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Partner API key. Finalized per partner integration agreement.
Headers
Optional account identifier for swag validation/filtering.
Query Parameters
Optional collection scope.
Minimum price filter. Inclusive.
Maximum price filter. Inclusive.
ISO 3166-1 alpha-2 country code (default US).
^[A-Z]{2}$Related entities to include (JSON:API include), comma-separated.
Supported values: brand, tags. Returned as full objects.
brand, tags Comma-separated list of field expansions for the synchronous export.
Same set as product list endpoints (priceRange, variantsCount).
total is omitted because export already returns every matching
product.
priceRange, variantsCount, full Response
Exported products.
Synchronous export JSON response. No pagination fields — every matching product is returned.
Show child attributes
Show child attributes
Was this page helpful?