{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/yelp/search-suggestions.json","title":"yelp/search-suggestions 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"]},"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":{"alias":{"description":"Optional alias supplied by this operation. Null means unknown.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"price_range":{"description":"Optional price range supplied by this operation. Null means unknown.","type":["string","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"]},"subtitle":{"description":"Optional subtitle 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":["alias"],"properties":{"alias":{"description":"Optional alias 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":["price_range"],"properties":{"price_range":{"description":"Optional price range supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"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":["subtitle"],"properties":{"subtitle":{"description":"Optional subtitle 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}}}]}]}},"location":{"description":"Optional location supplied by this operation. Null means unknown.","type":["string","null"]},"note":{"description":"Optional note supplied by this operation. Null means unknown.","type":["string","null"]},"partial":{"description":"Optional partial supplied by this operation. Null means unknown.","type":["boolean","null"]},"query":{"description":"Optional query supplied by this operation. Null means unknown.","type":["string","null"]},"row_types_missing":{"description":"Optional row types missing supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"row_types_served":{"description":"Optional row types served supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","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,"has_more":false,"items":[{"alias":"example","id":"example","price_range":"example","rating":{"max":0,"value":0,"votes":0},"reviews_count":0,"subtitle":"example","title":"example","type":"example","url":"https://example.com/example"}],"location":"example","note":"example","partial":false,"query":"example","row_types_missing":["example"],"row_types_served":["example"]}]}