OD. Media & Technology · Schema
etsyListingResponseSchema
Social MediaData APIDeveloper ToolsArtificial IntelligenceMarketing
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/scrapeatlas/json-schema/scrapeatlas-etsy-listing-response-schema-schema.json",
"title": "etsyListingResponseSchema",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/scrapeatlas-etsy-api-openapi.yml#/components/schemas/etsyListingResponseSchema",
"anyOf": [
{
"type": "object",
"properties": {
"requestId": {
"type": "string",
"format": "uuid"
},
"accounting": {
"type": "object",
"properties": {
"upstreamRequests": {
"type": "integer",
"minimum": 0
},
"responseBytes": {
"type": "integer",
"minimum": 0
},
"durationMs": {
"type": "number",
"minimum": 0
}
},
"required": [
"upstreamRequests",
"responseBytes",
"durationMs"
],
"additionalProperties": false
},
"success": {
"type": "boolean",
"const": true
},
"status": {
"type": "string",
"enum": [
"success",
"partial"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"coverage": {
"type": "object",
"properties": {
"source": {
"type": "string",
"enum": [
"public_page",
"public_api"
]
},
"complete": {
"type": "boolean"
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"enum": [
"malformed_cards_omitted",
"organic_results_partially_embedded",
"listing_count_unknown",
"review_pages_unknown",
"malformed_reviews_omitted"
]
}
}
},
"required": [
"source",
"complete",
"warnings"
],
"additionalProperties": false
},
"listing": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$"
},
"url": {
"type": "string",
"format": "uri"
},
"title": {
"type": "string",
"minLength": 1
},
"description": {
"type": [
"string",
"null"
]
},
"seller": {
"type": [
"string",
"null"
]
},
"shopId": {
"type": [
"string",
"null"
],
"pattern": "^[0-9]{1,20}$"
},
"shopUrl": {
"type": [
"string",
"null"
],
"format": "uri"
},
"price": {
"type": "object",
"properties": {
"current": {
"type": [
"number",
"null"
],
"minimum": 0
},
"original": {
"type": [
"number",
"null"
],
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"current",
"original",
"currency"
],
"additionalProperties": false
},
"discountPercent": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 100
},
"priceRange": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": "number",
"minimum": 0
},
"max": {
"type": "number",
"minimum": 0
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"rating": {
"type": "object",
"properties": {
"average": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 5
},
"count": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"required": [
"average",
"count"
],
"additionalProperties": false
},
"reviews_count": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"out_of_stock",
"unknown"
]
},
"quantity": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"inCarts": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"demandSignal": {
"type": [
"string",
"null"
]
},
"favorites": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"highlights": {
"type": "array",
"items": {
"type": "string"
}
},
"materials": {
"type": "array",
"items": {
"type": "string"
}
},
"variations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
],
"pattern": "^[0-9]{1,20}$"
},
"name": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"name",
"price"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"options"
],
"additionalProperties": false
}
},
"shipsFrom": {
"type": [
"string",
"null"
]
},
"shippingCost": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"returnsAccepted": {
"type": [
"boolean",
"null"
]
},
"listedAt": {
"type": [
"string",
"null"
]
},
"isStarSeller": {
"type": "boolean"
},
"shopRating": {
"type": "object",
"properties": {
"average": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 5
},
"count": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"required": [
"average",
"count"
],
"additionalProperties": false
},
"shopSales": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"reviewTags": {
"type": "array",
"items": {
"type": "string"
}
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"rating": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 5
},
"text": {
"type": "string"
}
},
"required": [
"author",
"date",
"rating",
"text"
],
"additionalProperties": false
}
},
"faq": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
},
"required": [
"question",
"answer"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"url",
"title",
"description",
"seller",
"shopId",
"shopUrl",
"price",
"discountPercent",
"priceRange",
"rating",
"reviews_count",
"image_urls",
"availability",
"quantity",
"inCarts",
"demandSignal",
"favorites",
"categories",
"highlights",
"materials",
"variations",
"shipsFrom",
"shippingCost",
"returnsAccepted",
"listedAt",
"isStarSeller",
"shopRating",
"shopSales",
"reviewTags",
"reviews",
"faq"
],
"additionalProperties": false
}
},
"required": [
"requestId",
"accounting",
"success",
"status",
"sourceUrl",
"fetchedAt",
"coverage",
"listing"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"requestId": {
"type": "string",
"format": "uuid"
},
"accounting": {
"type": "object",
"properties": {
"upstreamRequests": {
"type": "integer",
"minimum": 0
},
"responseBytes": {
"type": "integer",
"minimum": 0
},
"durationMs": {
"type": "number",
"minimum": 0
}
},
"required": [
"upstreamRequests",
"responseBytes",
"durationMs"
],
"additionalProperties": false
},
"success": {
"type": "boolean",
"const": false
},
"status": {
"type": "string",
"enum": [
"failed",
"challenged"
]
},
"failure": {
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_request",
"unauthorized",
"not_found",
"upstream_challenged",
"upstream_rate_limited",
"upstream_error",
"unsupported_page",
"response_too_large",
"unsafe_redirect",
"request_limit",
"timeout",
"busy",
"payload_too_complex"
]
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"requestId",
"accounting",
"success",
"status",
"failure"
],
"additionalProperties": false
}
]
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/scrapeatlas-etsy-listing-response-schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.