OD. Media & Technology · Schema
etsySearchResponseSchema
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-search-response-schema-schema.json",
"title": "etsySearchResponseSchema",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/scrapeatlas-etsy-api-openapi.yml#/components/schemas/etsySearchResponseSchema",
"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
},
"query": {
"type": "string"
},
"sort": {
"type": "string",
"enum": [
"most_relevant",
"price_low",
"price_high",
"highest_reviews",
"most_recent"
]
},
"page": {
"type": "integer",
"minimum": 1
},
"totalPages": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"nextPage": {
"type": [
"integer",
"null"
],
"minimum": 2
},
"listingIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$"
},
"maxItems": 48
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$"
},
"url": {
"type": "string",
"format": "uri"
},
"title": {
"type": "string"
},
"seller": {
"type": [
"string",
"null"
]
},
"shopId": {
"type": [
"string",
"null"
],
"pattern": "^[0-9]{1,20}$"
},
"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
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"rating": {
"type": "object",
"properties": {
"average": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 5
},
"count": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"required": [
"average",
"count"
],
"additionalProperties": false
},
"freeShipping": {
"type": "boolean"
},
"isBestseller": {
"type": "boolean"
},
"isAd": {
"type": "boolean"
}
},
"required": [
"id",
"url",
"title",
"seller",
"shopId",
"price",
"discountPercent",
"image_urls",
"rating",
"freeShipping",
"isBestseller",
"isAd"
],
"additionalProperties": false
},
"maxItems": 48
},
"ads": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[1-9][0-9]{0,15}$"
},
"url": {
"type": "string",
"format": "uri"
},
"title": {
"type": "string"
},
"seller": {
"type": [
"string",
"null"
]
},
"shopId": {
"type": [
"string",
"null"
],
"pattern": "^[0-9]{1,20}$"
},
"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
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"rating": {
"type": "object",
"properties": {
"average": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 5
},
"count": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"required": [
"average",
"count"
],
"additionalProperties": false
},
"freeShipping": {
"type": "boolean"
},
"isBestseller": {
"type": "boolean"
},
"isAd": {
"type": "boolean"
}
},
"required": [
"id",
"url",
"title",
"seller",
"shopId",
"price",
"discountPercent",
"image_urls",
"rating",
"freeShipping",
"isBestseller",
"isAd"
],
"additionalProperties": false
},
"maxItems": 48
}
},
"required": [
"requestId",
"accounting",
"success",
"status",
"sourceUrl",
"fetchedAt",
"coverage",
"query",
"sort",
"page",
"totalPages",
"nextPage",
"listingIds",
"items",
"ads"
],
"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-search-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.