{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/etsy/search.json","title":"etsy/search data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"cursor":{"description":"Opaque next-page token; pass it back unchanged. Null does not prove complete history.","type":["string","null"]},"has_more":{"description":"Source continuation indicator; null means unknown.","type":["boolean","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"bestseller":{"description":"Optional bestseller supplied by this operation. Null means unknown.","type":["boolean","null"]},"color_options":{"description":"Optional color options supplied by this operation. Null means unknown.","type":["number","null"]},"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string","null"]},"discount_percent":{"description":"Optional discount percent supplied by this operation. Null means unknown.","type":["number","null"]},"etsys_pick":{"description":"Optional etsys pick supplied by this operation. Null means unknown.","type":["boolean","null"]},"free_shipping":{"description":"Optional free shipping supplied by this operation. Null means unknown.","type":["boolean","null"]},"has_video":{"description":"Optional has video supplied by this operation. Null means unknown.","type":["boolean","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"image":{"description":"Optional image supplied by this operation. Null means unknown.","type":["string","null"]},"images":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"is_ad":{"description":"Optional is ad supplied by this operation. Null means unknown.","type":["boolean","null"]},"original_price":{"description":"Optional original price supplied by this operation. Null means unknown.","type":["number","null"]},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"popular_now":{"description":"Optional popular now supplied by this operation. Null means unknown.","type":["boolean","null"]},"price":{"description":"Source price. Currency, taxes and availability depend on the listing.","type":["number","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["object","null"],"properties":{"max":{"description":"Optional max supplied by this operation. Null means unknown.","type":["number","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]},"votes":{"description":"Optional votes supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"reviews_count":{"description":"Optional reviews count supplied by this operation. Null means unknown.","type":["number","null"]},"shop":{"description":"Optional shop supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true},"star_seller":{"description":"Optional star seller supplied by this operation. Null means unknown.","type":["boolean","null"]},"thumbnail":{"description":"Optional thumbnail supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["bestseller"],"properties":{"bestseller":{"description":"Optional bestseller supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["color_options"],"properties":{"color_options":{"description":"Optional color options supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["currency"],"properties":{"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["discount_percent"],"properties":{"discount_percent":{"description":"Optional discount percent supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["etsys_pick"],"properties":{"etsys_pick":{"description":"Optional etsys pick supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["free_shipping"],"properties":{"free_shipping":{"description":"Optional free shipping supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["has_video"],"properties":{"has_video":{"description":"Optional has video supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["image"],"properties":{"image":{"description":"Optional image supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["images"],"properties":{"images":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["is_ad"],"properties":{"is_ad":{"description":"Optional is ad supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["original_price"],"properties":{"original_price":{"description":"Optional original price supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["popular_now"],"properties":{"popular_now":{"description":"Optional popular now supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["price"],"properties":{"price":{"description":"Source price. Currency, taxes and availability depend on the listing.","type":["number"]}}},{"required":["rating"],"properties":{"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["object"],"properties":{"max":{"description":"Optional max supplied by this operation. Null means unknown.","type":["number","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]},"votes":{"description":"Optional votes supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["reviews_count"],"properties":{"reviews_count":{"description":"Optional reviews count supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["shop"],"properties":{"shop":{"description":"Optional shop supplied by this operation. Null means unknown.","type":["object"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}},{"required":["star_seller"],"properties":{"star_seller":{"description":"Optional star seller supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["thumbnail"],"properties":{"thumbnail":{"description":"Optional thumbnail supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}}]}]}},"page":{"description":"Optional page supplied by this operation. Null means unknown.","type":["number","null"]},"query":{"description":"Optional query supplied by this operation. Null means unknown.","type":["string","null"]},"sort":{"description":"Optional sort supplied by this operation. Null means unknown.","type":["string","null"]},"total":{"description":"Source-reported total; null is unknown.","type":["number","null"]}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"count":0,"cursor":null,"has_more":false,"items":[{"bestseller":false,"color_options":0,"currency":"example","discount_percent":0,"etsys_pick":false,"free_shipping":false,"has_video":false,"id":"example","image":"https://example.com/example","images":[],"is_ad":false,"original_price":0,"platform":"example","popular_now":false,"price":0,"rating":{"max":0,"value":0,"votes":0},"reviews_count":0,"shop":{"id":"example","name":"example","url":"https://example.com/example"},"star_seller":false,"thumbnail":"example","title":"example","type":"example","url":"https://example.com/example"}],"page":0,"query":"example","sort":"example","total":0}]}