{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/ebay/product.json","title":"ebay/product 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"]}},"additional_image_urls":{"description":"Optional additional image urls supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"adult_only":{"description":"Optional adult only supplied by this operation. Null means unknown.","type":["boolean","null"]},"aspects":{"description":"Optional aspects 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":{"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}},"availability_status":{"description":"Optional availability status supplied by this operation. Null means unknown.","type":["string","null"]},"brand":{"description":"Optional brand supplied by this operation. Null means unknown.","type":["string","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"]}},"category_id":{"description":"Optional category id supplied by this operation. Null means unknown.","type":["string","null"]},"category_path":{"description":"Optional category path supplied by this operation. Null means unknown.","type":["string","null"]},"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"]},"epid":{"description":"Optional epid supplied by this operation. Null means unknown.","type":["string","null"]},"gtin":{"description":"Optional gtin 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_creation_date":{"description":"Optional item creation date 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":{"city":{"description":"Optional city supplied by this operation. Null means unknown.","type":["string","null"]},"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"]},"state":{"description":"Optional state 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"]},"mpn":{"description":"Optional mpn 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},"quantity_sold":{"description":"Optional quantity sold supplied by this operation. Null means unknown.","type":["number","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["object","null"],"properties":{"average":{"description":"Optional average supplied by this operation. Null means unknown.","type":["number","null"]},"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]}},"additionalProperties":true},"returns_accepted":{"description":"Optional returns accepted supplied by this operation. Null means unknown.","type":["boolean","null"]},"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":{"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},"service":{"description":"Optional service supplied by this operation. Null means unknown.","type":["string","null"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"short_description":{"description":"Optional short description supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"top_rated":{"description":"Optional top rated supplied by this operation. Null means unknown.","type":["boolean","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["additional_image_urls"],"properties":{"additional_image_urls":{"description":"Optional additional image urls supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["adult_only"],"properties":{"adult_only":{"description":"Optional adult only supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["aspects"],"properties":{"aspects":{"description":"Optional aspects supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}}},{"required":["availability_status"],"properties":{"availability_status":{"description":"Optional availability status supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["brand"],"properties":{"brand":{"description":"Optional brand supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"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":["category_id"],"properties":{"category_id":{"description":"Optional category id supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["category_path"],"properties":{"category_path":{"description":"Optional category path supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"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":["epid"],"properties":{"epid":{"description":"Optional epid supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["gtin"],"properties":{"gtin":{"description":"Optional gtin 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_creation_date"],"properties":{"item_creation_date":{"description":"Optional item creation date 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":{"city":{"description":"Optional city supplied by this operation. Null means unknown.","type":["string","null"]},"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"]},"state":{"description":"Optional state 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":["mpn"],"properties":{"mpn":{"description":"Optional mpn 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":["quantity_sold"],"properties":{"quantity_sold":{"description":"Optional quantity sold supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["rating"],"properties":{"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["object"],"properties":{"average":{"description":"Optional average supplied by this operation. Null means unknown.","type":["number","null"]},"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]}},"additionalProperties":true}}},{"required":["returns_accepted"],"properties":{"returns_accepted":{"description":"Optional returns accepted supplied by this operation. Null means unknown.","type":["boolean"]}}},{"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":{"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},"service":{"description":"Optional service supplied by this operation. Null means unknown.","type":["string","null"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}},{"required":["short_description"],"properties":{"short_description":{"description":"Optional short description 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":["top_rated"],"properties":{"top_rated":{"description":"Optional top rated supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"_warnings":["example"],"additional_image_urls":["example"],"adult_only":false,"aspects":[{"name":"example","value":"example"}],"availability_status":"example","brand":"example","buying_options":["example"],"category_id":"example","category_path":"example","condition":"example","condition_id":"example","epid":"example","gtin":"example","id":"example","image_url":"https://example.com/example","item_creation_date":"2026-09-01T12:00:00Z","item_location":{"city":"example","country":"example","postal_code":"example","state":"example"},"legacy_id":"example","marketplace_id":"example","mpn":"example","price":{"currency":"example","value":0},"quantity_sold":0,"rating":{"average":0,"count":0},"returns_accepted":false,"seller":{"feedback_percentage":0,"feedback_score":0,"username":"example"},"shipping":{"cost":{"currency":"example","value":0},"service":"example","type":"example"},"short_description":"example","title":"example","top_rated":false,"url":"https://example.com/example"}]}