{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/ebay/search.json","title":"ebay/search data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"_warnings":{"description":"Optional  warnings supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"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"]},"dropped":{"description":"Optional dropped supplied by this operation. Null means unknown.","type":["number","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":{"adult_only":{"description":"Optional adult only supplied by this operation. Null means unknown.","type":["boolean","null"]},"bid_count":{"description":"Optional bid count supplied by this operation. Null means unknown.","type":["number","null"]},"buying_options":{"description":"Optional buying options supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"categories":{"description":"Optional categories supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}},"condition":{"description":"Optional condition supplied by this operation. Null means unknown.","type":["string","null"]},"condition_id":{"description":"Optional condition id supplied by this operation. Null means unknown.","type":["string","null"]},"current_bid_price":{"description":"Optional current bid price supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"epid":{"description":"Optional epid supplied by this operation. Null means unknown.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"image_url":{"description":"Optional image url supplied by this operation. Null means unknown.","type":["string","null"]},"item_location":{"description":"Optional item location supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"postal_code":{"description":"Optional postal code supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"legacy_id":{"description":"Optional legacy id supplied by this operation. Null means unknown.","type":["string","null"]},"marketplace_id":{"description":"Optional marketplace id supplied by this operation. Null means unknown.","type":["string","null"]},"price":{"description":"Source price. Currency, taxes and availability depend on the listing.","type":["object","null"],"properties":{"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"seller":{"description":"Optional seller supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"feedback_percentage":{"description":"Optional feedback percentage supplied by this operation. Null means unknown.","type":["number","null"]},"feedback_score":{"description":"Optional feedback score supplied by this operation. Null means unknown.","type":["number","null"]},"username":{"description":"Optional username supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"shipping":{"description":"Optional shipping supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"cost":{"description":"Optional cost supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["adult_only"],"properties":{"adult_only":{"description":"Optional adult only supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["bid_count"],"properties":{"bid_count":{"description":"Optional bid count supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["buying_options"],"properties":{"buying_options":{"description":"Optional buying options supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["categories"],"properties":{"categories":{"description":"Optional categories supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}}}},{"required":["condition"],"properties":{"condition":{"description":"Optional condition supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["condition_id"],"properties":{"condition_id":{"description":"Optional condition id supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["current_bid_price"],"properties":{"current_bid_price":{"description":"Optional current bid price supplied by this operation. Null means unknown.","type":["object"],"properties":{"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["epid"],"properties":{"epid":{"description":"Optional epid supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["image_url"],"properties":{"image_url":{"description":"Optional image url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["item_location"],"properties":{"item_location":{"description":"Optional item location supplied by this operation. Null means unknown.","type":["object"],"properties":{"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"postal_code":{"description":"Optional postal code supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}},{"required":["legacy_id"],"properties":{"legacy_id":{"description":"Optional legacy id supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["marketplace_id"],"properties":{"marketplace_id":{"description":"Optional marketplace id supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["price"],"properties":{"price":{"description":"Source price. Currency, taxes and availability depend on the listing.","type":["object"],"properties":{"currency":{"description":"Optional currency supplied by this operation. Null means unknown.","type":["string","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["seller"],"properties":{"seller":{"description":"Optional seller supplied by this operation. Null means unknown.","type":["object"],"properties":{"feedback_percentage":{"description":"Optional feedback percentage supplied by this operation. Null means unknown.","type":["number","null"]},"feedback_score":{"description":"Optional feedback score supplied by this operation. Null means unknown.","type":["number","null"]},"username":{"description":"Optional username supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}},{"required":["shipping"],"properties":{"shipping":{"description":"Optional shipping supplied by this operation. Null means unknown.","type":["object"],"properties":{"cost":{"description":"Optional cost supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}},{"required":["thumbnail_url"],"properties":{"thumbnail_url":{"description":"Optional thumbnail url 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}}}]}]}},"marketplace_id":{"description":"Optional marketplace id supplied by this operation. Null means unknown.","type":["string","null"]},"query":{"description":"Optional query 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":[{"_warnings":["example"],"count":0,"cursor":null,"dropped":0,"items":[{"adult_only":false,"bid_count":0,"buying_options":["example"],"categories":[{}],"condition":"example","condition_id":"example","current_bid_price":{"currency":"example","value":0},"epid":"example","id":"example","image_url":"https://example.com/example","item_location":{"country":"example","postal_code":"example"},"legacy_id":"example","marketplace_id":"example","price":{"currency":"example","value":0},"seller":{"feedback_percentage":0,"feedback_score":0,"username":"example"},"shipping":{"cost":{},"type":"example"},"thumbnail_url":"https://example.com/example","title":"example","url":"https://example.com/example"}],"marketplace_id":"example","query":"example","total":0}]}