{"data":{"marketplaces":[{"id":"aliexpress","operations":["search","browse","categories","image-search","product","shipping"],"includes":[],"regions":["US"],"cost":{"browse":{"base":1,"max":1},"categories":{"base":1,"max":1},"image-search":{"base":1,"max":1},"product":{"base":1,"max":2},"search":{"base":1,"max":1},"shipping":{"base":1,"max":2}},"params":{"browse":{"additionalProperties":false,"properties":{"categoryId":{"description":"AliExpress category id to list. Required — this is what is being browsed.","type":"string"},"currency":{"description":"Presentment currency.","type":"string"},"language":{"description":"Presentment language.","type":"string"},"page":{"description":"1-based page number.","minimum":1,"type":"integer"},"pageSize":{"description":"Results per page, 1-50.","minimum":1,"type":"integer"},"priceMax":{"description":"Highest price to return, in decimal major units.","minimum":0,"type":"number"},"priceMin":{"description":"Lowest price to return, in decimal major units.","minimum":0,"type":"number"},"region":{"description":"Buyer country (ISO 3166-1 alpha-2); sets shipping and availability.","type":"string"},"sort":{"description":"Result ordering, in the shared vocabulary.","enum":["price_asc","price_desc","best_seller"],"type":"string"}},"required":["categoryId"],"type":"object"},"categories":{"additionalProperties":false,"properties":{"categoryId":{"description":"Parent category id. Omit for the top-level categories.","type":"string"}},"type":"object"},"image-search":{"additionalProperties":false,"properties":{"currency":{"description":"Presentment currency.","type":"string"},"image":{"description":"{contentType, data} with base64-encoded image bytes.","type":"object"},"language":{"description":"Presentment language.","type":"string"},"region":{"description":"Buyer country (ISO 3166-1 alpha-2).","type":"string"}},"required":["image"],"type":"object"},"product":{"additionalProperties":false,"properties":{"currency":{"description":"Presentment currency.","type":"string"},"id":{"description":"AliExpress product id, as carried by a search item.","type":"string"},"include":{"description":"include=shipping adds `delivery`: the cheapest shipping cost and delivery days to `region` for the product's listed variant. Costs one more unit.","enum":["shipping"],"type":"string"},"language":{"description":"Presentment language.","type":"string"},"region":{"description":"Buyer country (ISO 3166-1 alpha-2).","type":"string"}},"required":["id"],"type":"object"},"search":{"additionalProperties":false,"properties":{"categoryId":{"description":"AliExpress category id; narrows the search.","type":"string"},"currency":{"description":"Presentment currency.","type":"string"},"language":{"description":"Presentment language.","type":"string"},"page":{"description":"1-based page number.","minimum":1,"type":"integer"},"pageSize":{"description":"Results per page, 1-50.","minimum":1,"type":"integer"},"priceMax":{"description":"Highest price to return, in decimal major units.","minimum":0,"type":"number"},"priceMin":{"description":"Lowest price to return, in decimal major units.","minimum":0,"type":"number"},"query":{"description":"Keywords. Required — AliExpress keyword search cannot be asked anything without words.","type":"string"},"region":{"description":"Buyer country (ISO 3166-1 alpha-2); sets shipping and availability.","type":"string"},"sort":{"description":"Result ordering, in the shared vocabulary.","enum":["price_asc","price_desc","best_seller"],"type":"string"}},"required":["query"],"type":"object"},"shipping":{"additionalProperties":false,"properties":{"currency":{"description":"Currency for the shipping fee. Default USD.","type":"string"},"id":{"description":"AliExpress product id.","type":"string"},"quantity":{"description":"How many units are shipped together. Default 1.","minimum":1,"type":"integer"},"region":{"description":"Destination country (ISO 3166-1 alpha-2). Default US.","type":"string"},"sku":{"description":"The variant to quote: a variant `id` from the product, or a numeric sku id. Omit for the product's listed variant.","type":"string"}},"required":["id"],"type":"object"}}},{"id":"amazon","kind":"marketplace","operations":["search","image-search","browse","categories","product"],"includes":["offers","facets"],"regions":["US","CA","MX","BR","FR","IT","ES","NL","SE","TR","AE","SA","IN","JP","SG","AU"],"cost":{"browse":{"base":1,"max":2},"categories":{"base":1,"max":1},"image-search":{"base":1,"max":2},"product":{"base":2,"max":32},"search":{"base":1,"max":2}},"params":{"browse":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"description":"REQUIRED. An Amazon browse NODE — the digits from a category URL, e.g. `172541`. The department slugs `categories` returns at its root (`electronics`) are NOT browse nodes and are refused with `CATEGORY_NOT_BROWSABLE`: call `categories` with the slug to get its child nodes and browse one of those."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based page number; each page is charged separately. There is no `pageSize` (Amazon fixes the count per page, 13-47 in practice) and no `cursor` — paging is by number."},"region":{"type":"string","enum":["US","CA","MX","BR","FR","IT","ES","NL","SE","TR","AE","SA","IN","JP","SG","AU"],"description":"Which Amazon marketplace to query, by buyer country: US, CA, MX, BR, FR, IT, ES, NL, SE, TR, AE, SA, IN, JP, SG, AU. Defaults to US. Prices come back in that marketplace's own currency (JP in JPY, FR in EUR)."},"brands":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Brand names as Amazon spells them, e.g. brands=Nike,Adidas. A call that uses `brands` costs 2 units instead of 1. Not available on amazon.fr (`region=FR`)."},"facets":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"name":{"type":"string","minLength":1},"value":{"type":"string","minLength":1}},"required":["name","value"],"additionalProperties":false}]}}],"description":"Narrowings taken from a result's `facets`, e.g. facets=Color:Black. A call that uses `facets` costs 2 units instead of 1. Not available on amazon.fr (`region=FR`)."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"ratingMin":{"type":"number","description":"`4` only. Amazon's rating filter offers exactly one threshold, \"4 Stars \u0026 Up\"; any other value is a 400 rather than a silently different search. Not available on amazon.fr (`region=FR`)."},"sort":{"type":"string","enum":["best_match","price_asc","price_desc","newly_listed","avg_review"],"description":"Result ordering: `best_match`, `price_asc`, `price_desc`, `newly_listed` or `avg_review`. Defaults to `best_match`, Amazon's own relevance ordering."}},"required":["categoryId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"categories":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"description":"Omit for the 40 departments; give a browse node (`172541`) or a department slug (`electronics`) to list that category's children. This is the one endpoint that takes either kind of id."},"region":{"type":"string","enum":["US","CA","MX","BR","FR","IT","ES","NL","SE","TR","AE","SA","IN","JP","SG","AU"],"description":"Which Amazon marketplace to query, by buyer country: US, CA, MX, BR, FR, IT, ES, NL, SE, TR, AE, SA, IN, JP, SG, AU. Defaults to US. Prices come back in that marketplace's own currency (JP in JPY, FR in EUR)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"image-search":{"type":"object","properties":{"image":{"type":"object","properties":{"contentType":{"type":"string","pattern":"^image\\/(jpeg|jpg|png|gif)$","description":"`image/jpeg`, `image/png` or `image/gif`. WebP and HEIC are not read by Amazon's visual search and are refused rather than answered with an empty result."},"data":{"type":"string","minLength":1,"maxLength":6000000,"description":"Base64-encoded image bytes, up to ~6 MB of base64."}},"required":["contentType","data"],"additionalProperties":false,"description":"The picture to search by: `{contentType, data}` with `data` base64-encoded. POST only — a base64 image is tens of kilobytes and a URL caps out around 8 KB."},"query":{"type":"string","minLength":1,"description":"Optional words that narrow the visual matches, e.g. the product type. Supplying it is usually much more precise."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based page number over the visual matches, about 48 per page; each page is charged separately. No `pageSize` and no `cursor`."},"region":{"type":"string","enum":["US","CA","MX","BR","FR","IT","ES","NL","SE","TR","AE","SA","IN","JP","SG","AU"],"description":"Which Amazon marketplace to query, by buyer country: US, CA, MX, BR, FR, IT, ES, NL, SE, TR, AE, SA, IN, JP, SG, AU. Defaults to US. Prices come back in that marketplace's own currency (JP in JPY, FR in EUR)."},"categoryId":{"type":"string","minLength":1,"description":"Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's `facets`."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"ratingMin":{"type":"number","description":"`4` only. Amazon's rating filter offers exactly one threshold, \"4 Stars \u0026 Up\"; any other value is a 400 rather than a silently different search. Not available on amazon.fr (`region=FR`)."},"sort":{"type":"string","enum":["best_match","price_asc","price_desc","newly_listed","avg_review"],"description":"Result ordering: `best_match`, `price_asc`, `price_desc`, `newly_listed` or `avg_review`. Defaults to `best_match`, Amazon's own relevance ordering."}},"required":["image"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"product":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"The marketplace's own product id, as carried by a search item."},"include":{"type":"string","description":"`offers` · `offers:5` · `offers:all` — the enumerated competing-seller offers, which are fetched separately and so opt-in. Depth counts pages of offers (10 offers each) and each page is charged; `all` walks to the end, capped at 30 pages."},"region":{"type":"string","enum":["US","CA","MX","BR","FR","IT","ES","NL","SE","TR","AE","SA","IN","JP","SG","AU"],"description":"Which Amazon marketplace to query, by buyer country: US, CA, MX, BR, FR, IT, ES, NL, SE, TR, AE, SA, IN, JP, SG, AU. Defaults to US. Prices come back in that marketplace's own currency (JP in JPY, FR in EUR)."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Keywords to search for. Required here; to search by picture use `image-search`."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based page number; each page is charged separately. There is no `pageSize` (Amazon fixes the count per page by keyword, 13-47 in practice) and no `cursor` — paging is by number."},"region":{"type":"string","enum":["US","CA","MX","BR","FR","IT","ES","NL","SE","TR","AE","SA","IN","JP","SG","AU"],"description":"Which Amazon marketplace to query, by buyer country: US, CA, MX, BR, FR, IT, ES, NL, SE, TR, AE, SA, IN, JP, SG, AU. Defaults to US. Prices come back in that marketplace's own currency (JP in JPY, FR in EUR)."},"categoryId":{"type":"string","minLength":1,"description":"Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's `facets`."},"brands":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Brand names as Amazon spells them, e.g. brands=Nike,Adidas. A call that uses `brands` costs 2 units instead of 1. Not available on amazon.fr (`region=FR`)."},"facets":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"name":{"type":"string","minLength":1},"value":{"type":"string","minLength":1}},"required":["name","value"],"additionalProperties":false}]}}],"description":"Narrowings taken from a result's `facets`, e.g. facets=Color:Black. A call that uses `facets` costs 2 units instead of 1. Not available on amazon.fr (`region=FR`)."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Expansions that cost more than the default answer, e.g. include=facets."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"ratingMin":{"type":"number","description":"`4` only. Amazon's rating filter offers exactly one threshold, \"4 Stars \u0026 Up\"; any other value is a 400 rather than a silently different search. Not available on amazon.fr (`region=FR`)."},"sort":{"type":"string","enum":["best_match","price_asc","price_desc","newly_listed","avg_review"],"description":"Result ordering: `best_match`, `price_asc`, `price_desc`, `newly_listed` or `avg_review`. Defaults to `best_match`, Amazon's own relevance ordering."}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"app-store","kind":"serp","operations":["search","app","reviews"],"includes":[],"regions":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","CN","TW","HK","MX","BR","AR","CL","CO","PE"],"cost":{"app":{"base":1,"max":1},"reviews":{"base":1,"max":5},"search":{"base":1,"max":1}},"params":{"app":{"type":"object","properties":{"id":{"type":"string","pattern":"^\\d{5,12}$","description":"The app's App Store id: the number in its link (`…/id426826309`)."},"url":{"type":"string","pattern":"^https:\\/\\/(?:apps|itunes)\\.apple\\.com\\/[^?#]*\\/id\\d{5,12}(?:[/?#].*)?$","description":"The app's App Store link, instead of `id`."},"country":{"type":"string","enum":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","CN","TW","HK","MX","BR","AR","CL","CO","PE"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"id":{"type":"string","pattern":"^\\d{5,12}$","description":"The app's App Store id: the number in its link (`…/id426826309`)."},"url":{"type":"string","pattern":"^https:\\/\\/(?:apps|itunes)\\.apple\\.com\\/[^?#]*\\/id\\d{5,12}(?:[/?#].*)?$","description":"The app's App Store link, instead of `id`."},"country":{"type":"string","enum":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","CN","TW","HK","MX","BR","AR","CL","CO","PE"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"sort":{"type":"string","enum":["relevant","newest","highest","lowest"],"description":"Review order."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 20, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","CN","TW","HK","MX","BR","AR","CL","CO","PE"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Results wanted (default 50, at most 200). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"baidu","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["CN"],"cost":{"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"image":{"type":"string","format":"uri","description":"An image URL: a reverse-image search instead of `q` (`type=image`)."},"type":{"type":"string","enum":["web","news","images","videos","image"],"description":"What to search: web results (default), news, images, videos or `image` for a reverse-image search."},"country":{"type":"string","enum":["CN"],"description":"The market, as an ISO 3166 country code."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Results wanted (default 10, at most 50). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["CN"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"bing","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"cost":{"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"image":{"type":"string","format":"uri","description":"An image URL: a reverse-image search instead of `q` (`type=image`)."},"type":{"type":"string","enum":["web","news","images","videos","image"],"description":"What to search: web results (default), news, images, videos or `image` for a reverse-image search."},"country":{"type":"string","enum":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"safe":{"type":"string","enum":["on","off"],"description":"Safe search."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Results wanted (default 10, at most 50). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"chatgpt","kind":"answers","operations":["answer"],"includes":["page"],"regions":["US","DE","GB","AT","KR","AU","JP","CA","FR","IT"],"cost":{"answer":{"base":1,"max":1}},"params":{"answer":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":16000,"description":"The question, as a person would type it."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries."},"conversation":{"type":"string","minLength":1,"maxLength":200,"description":"An earlier answer's `conversation.id`: ask a follow-up in the same conversation."},"photos":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":4,"description":"Up to four photos to ask about: https URLs, or `data:image/…;base64,` URLs."},"include":{"anyOf":[{"type":"array","items":{"type":"string","enum":["details","page"]}},{"type":"string"}],"description":"`page`: also return the answer as a self-contained HTML page, in `page`."}},"required":["prompt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"daum","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["KR"],"cost":{"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["KR"],"description":"The market, as an ISO 3166 country code."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"limit":{"type":"integer","minimum":1,"maximum":240,"description":"Results wanted (default 10, at most 240). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["KR"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"duckduckgo","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["US","GB","CA","AU","IN","DE","FR","IT","ES","NL","BR","MX","JP","KR"],"cost":{"search":{"base":1,"max":10},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["US","GB","CA","AU","IN","DE","FR","IT","ES","NL","BR","MX","JP","KR"],"description":"The market, as an ISO 3166 country code."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"safe":{"type":"string","enum":["on","off"],"description":"Safe search."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 10, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","GB","CA","AU","IN","DE","FR","IT","ES","NL","BR","MX","JP","KR"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"gemini","kind":"answers","operations":["answer"],"includes":["page"],"regions":["US","DE","GB","AT","KR","AU","JP","CA","FR","IT"],"cost":{"answer":{"base":1,"max":1}},"params":{"answer":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":16000,"description":"The question, as a person would type it."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries."},"conversation":{"type":"string","minLength":1,"maxLength":200,"description":"An earlier answer's `conversation.id`: ask a follow-up in the same conversation."},"include":{"anyOf":[{"type":"array","items":{"type":"string","enum":["details","page"]}},{"type":"string"}],"description":"`page`: also return the answer as a self-contained HTML page, in `page`."}},"required":["prompt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"google","kind":"serp","operations":["search","suggestions","places","place"],"includes":[],"regions":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"cost":{"place":{"base":1,"max":1},"places":{"base":1,"max":3},"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"place":{"type":"object","properties":{"id":{"type":"string","pattern":"0x[0-9a-f]{1,16}:0x[0-9a-f]{1,16}","description":"The place's id, as `places` returns it."},"url":{"type":"string","format":"uri","pattern":"0x[0-9a-f]{1,16}:0x[0-9a-f]{1,16}","description":"A Google Maps place URL."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"places":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"location":{"type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?$","description":"Search as if from this point: `lat,lng`."},"near":{"type":"string","minLength":1,"maxLength":200,"description":"Search around this place name, or a `lat,lng` point."},"country":{"type":"string","enum":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"limit":{"type":"integer","minimum":1,"maximum":60,"description":"Results wanted (default 20, at most 60). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"image":{"type":"string","format":"uri","description":"An image URL: a reverse-image search instead of `q` (`type=image`)."},"type":{"type":"string","enum":["web","news","images","videos","image"],"description":"What to search: web results (default), news, images, videos or `image` for a reverse-image search."},"country":{"type":"string","enum":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"safe":{"type":"string","enum":["on","off"],"description":"Safe search."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Results wanted (default 10, at most 50). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","GB","CA","AU","DE","FR","IT","AT","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"google-ai-mode","kind":"answers","operations":["answer"],"includes":["page"],"regions":["US"],"cost":{"answer":{"base":1,"max":1}},"params":{"answer":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":16000,"description":"The question, as a person would type it."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries."},"language":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$","description":"The language to answer in, as a language tag (`en`, `ko-KR`)."},"conversation":{"type":"string","minLength":1,"maxLength":200,"description":"An earlier answer's `conversation.id`: ask a follow-up in the same conversation."},"include":{"anyOf":[{"type":"array","items":{"type":"string","enum":["details","page"]}},{"type":"string"}],"description":"`page`: also return the answer as a self-contained HTML page, in `page`."}},"required":["prompt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"google-aio","kind":"answers","operations":["answer"],"includes":["page"],"regions":["US"],"cost":{"answer":{"base":1,"max":1}},"params":{"answer":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":16000,"description":"The question, as a person would type it."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries."},"language":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$","description":"The language to answer in, as a language tag (`en`, `ko-KR`)."},"include":{"anyOf":[{"type":"array","items":{"type":"string","enum":["details","page"]}},{"type":"string"}],"description":"`page`: also return the answer as a self-contained HTML page, in `page`."}},"required":["prompt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"google-play","kind":"serp","operations":["search","app","reviews"],"includes":[],"regions":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","TW","HK","MX","BR","AR","CL","CO","PE"],"cost":{"app":{"base":1,"max":1},"reviews":{"base":1,"max":1},"search":{"base":1,"max":1}},"params":{"app":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*(?:\\.[A-Za-z0-9_]+)+$","description":"The app's Play id: its package name (`com.strava`)."},"url":{"type":"string","pattern":"^https:\\/\\/play\\.google\\.com\\/store\\/apps\\/details\\?(?:.*\u0026)?id=[A-Za-z][A-Za-z0-9_.]*(?:[\u0026#].*)?$","description":"The app's Play link, instead of `id`."},"country":{"type":"string","enum":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","TW","HK","MX","BR","AR","CL","CO","PE"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*(?:\\.[A-Za-z0-9_]+)+$","description":"The app's Play id: its package name (`com.strava`)."},"url":{"type":"string","pattern":"^https:\\/\\/play\\.google\\.com\\/store\\/apps\\/details\\?(?:.*\u0026)?id=[A-Za-z][A-Za-z0-9_.]*(?:[\u0026#].*)?$","description":"The app's Play link, instead of `id`."},"country":{"type":"string","enum":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","TW","HK","MX","BR","AR","CL","CO","PE"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"sort":{"type":"string","enum":["relevant","newest","highest","lowest"],"description":"Review order."},"rating":{"type":"integer","minimum":1,"maximum":5,"description":"Only reviews with this many stars (1-5)."},"device":{"type":"string","enum":["phone","tablet","watch","chromebook","tv","car"],"description":"Reviews written on this kind of device (default phone)."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Results wanted (default 40, at most 200). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","GB","CA","AU","NZ","IE","DE","FR","IT","ES","NL","BE","AT","CH","SE","NO","DK","FI","PL","PT","CZ","GR","HU","RO","TR","UA","IL","AE","SA","EG","ZA","NG","KE","IN","PK","ID","MY","SG","TH","VN","PH","JP","KR","TW","HK","MX","BR","AR","CL","CO","PE"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"limit":{"type":"integer","minimum":1,"maximum":30,"description":"Results wanted (default 30, at most 30). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"google-shopping","kind":"serp","operations":["search","product","reviews"],"includes":["facets","offers"],"regions":["US","GB","CA","AU"],"cost":{"product":{"base":1,"max":21},"reviews":{"base":1,"max":1},"search":{"base":1,"max":1}},"params":{"product":{"type":"object","properties":{"id":{"type":"string","pattern":"^(?:\\d{6,24}|c\\d{6,24}|p\\d{6,24}(?:-\\d{6,24})?)$","description":"The product, as a search item's `id` carries it."},"url":{"type":"string","format":"uri","description":"A Google Shopping product link instead of `id` (the `url` a search item carries)."},"include":{"type":"string","description":"`offers` · `offers:5` · `offers:all` — every merchant selling the product, 10 per request after the 3 the page shows. Depth counts requests and each is charged; `all` walks to the end, capped at 20."},"region":{"type":"string","enum":["US","GB","CA","AU"],"description":"The market, ISO 3166-1 alpha-2: US (default), GB, CA, AU. Sets the shops, prices and currency."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"id":{"type":"string","pattern":"^(?:\\d{6,24}|c\\d{6,24}|p\\d{6,24}(?:-\\d{6,24})?)$","description":"The product, as a search item's `id` carries it. Only a product Google groups across stores (an id of digits only) has reviews."},"url":{"type":"string","format":"uri","description":"A Google Shopping product link instead of `id` (the `url` a search item carries)."},"cursor":{"type":"string","description":"Next page: pass the previous result's `cursor` alone."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":400,"description":"Keywords to search for."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price, in the market's currency (decimal major units)."},"priceMax":{"type":"number","minimum":0,"description":"Highest price, in the market's currency (decimal major units)."},"facets":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"name":{"type":"string","minLength":1},"value":{"type":"string","minLength":1}},"required":["name","value"],"additionalProperties":false}]}}],"description":"One value from a result's `facets` (include=facets), e.g. facets=Brand:\u003cvalue\u003e. Google applies one at a time."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"`facets` — the filter rail Google shows beside the results, on the same page (no extra request)."},"region":{"type":"string","enum":["US","GB","CA","AU"],"description":"The market, ISO 3166-1 alpha-2: US (default), GB, CA, AU. Sets the shops, prices and currency."},"cursor":{"type":"string","description":"Next page: pass the previous result's `cursor` alone."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"google-trends","kind":"serp","operations":["explore","trending"],"includes":["articles"],"regions":["US","AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"cost":{"explore":{"base":1,"max":1},"trending":{"base":1,"max":2}},"params":{"explore":{"type":"object","properties":{"terms":{"type":"string","minLength":1,"maxLength":520,"description":"Up to five search terms to compare, separated by commas."},"country":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"description":"The country, as an ISO 3166 code. Absent: worldwide."},"subregion":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}(?:-\\d{3})?$","description":"A state, province or US metro inside `country` (`US-CA`, `US-CA-807`), instead of the whole country."},"timeRange":{"type":"string","enum":["hour","4hours","day","week","month","quarter","year","5years","all"],"description":"The period: the past hour, 4 hours, day, week (7 days), month, quarter (3 months), year (12 months, the default), 5 years, or `all` (since 2004)."},"from":{"type":"string","description":"A custom period's first day (`YYYY-MM-DD`), or hour within the past week (`YYYY-MM-DDTHH`), with `to`."},"to":{"type":"string","description":"A custom period's last day (`YYYY-MM-DD`) or hour (`YYYY-MM-DDTHH`), with `from`."},"category":{"type":"integer","minimum":0,"description":"A Trends category id, to measure the terms within it (0 = all categories)."},"property":{"type":"string","enum":["web","images","news","shopping","youtube"],"description":"Which Google search: web (default), images, news, shopping or youtube."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language: the language of topic names and labels (`en`, `pt-BR`)."},"resolution":{"type":"string","enum":["country","region","metro","city"],"description":"Interest by region by country, region, metro (US only) or city. Default: the next level below the place asked."},"lowVolume":{"anyOf":[{"type":"string","enum":["true","false"]},{"type":"boolean"}],"description":"Include regions with low search volume in interest by region."}},"required":["terms"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"trending":{"type":"object","properties":{"country":{"type":"string","enum":["AE","AL","AM","AO","AR","AT","AU","AZ","BA","BD","BE","BF","BG","BH","BJ","BO","BR","BY","CA","CD","CH","CI","CL","CM","CO","CR","CU","CY","CZ","DE","DK","DO","DZ","EC","EE","EG","ES","ET","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IT","JM","JO","JP","KE","KG","KH","KR","KW","KZ","LB","LK","LT","LV","LY","MA","MD","MK","ML","MM","MX","MY","MZ","NG","NI","NL","NO","NP","NZ","OM","PA","PE","PH","PK","PL","PR","PS","PT","PY","QA","RO","RS","RU","SA","SE","SG","SI","SK","SN","SV","SY","TH","TM","TN","TR","TT","TW","TZ","UA","UG","US","UY","UZ","VE","VN","YE","ZA","ZM","ZW"],"description":"The country, as an ISO 3166 code."},"subregion":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}(?:-\\d{3})?$","description":"A state or province inside `country` (`US-CA`)."},"window":{"type":"string","enum":["4h","24h","48h","7d"],"description":"The period: past 4 hours, 24 hours (default), 48 hours or 7 days."},"category":{"type":"integer","description":"Only trends in this category (trending now's own 1-20; 0 = all)."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language: the language of topic names and labels (`en`, `pt-BR`)."},"include":{"type":"string","enum":["articles"],"description":"`articles`: every news article Trends holds for each trend, for the first 300 trends (charged as one more unit)."}},"required":["country"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"instagram","kind":"sns","operations":["profile","post","posts","comments","group","groups"],"includes":[],"regions":["US"],"cost":{"comments":{"base":1,"max":1},"group":{"base":1,"max":1},"groups":{"base":1,"max":1},"post":{"base":1,"max":1},"posts":{"base":1,"max":1},"profile":{"base":1,"max":1}},"params":{"comments":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"The post's comments: shortcode or URL."},"sort":{"type":"string","enum":["recent"],"description":"recent (newest first) — the only order Instagram serves logged-out visitors."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"group":{"type":"object","properties":{"hashtag":{"type":"string","minLength":1,"description":"A hashtag: with or without #, or its page URL."},"location":{"type":"string","minLength":1,"description":"A location: numeric id or URL (…/explore/locations/\u003cid\u003e/)."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Attach from the same page, at no extra cost: posts (the tag's top posts / the location's posts, ext.posts)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"groups":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"type":{"type":"string","enum":["highlights"],"description":"highlights (a creator's highlight reels)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Post shortcode, or the post URL (…/p/\u003ccode\u003e/, …/reel/\u003ccode\u003e/, …/tv/\u003ccode\u003e/)."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Attach from the same page, at no extra cost: comments (the first comments, ext.comments), authorPosts (the author's other recent posts, ext.authorPosts)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"type":{"type":"string","enum":["posts","reels"],"description":"username: the creator's posts (default) or reels."},"hashtag":{"type":"string","minLength":1,"description":"Top posts under a hashtag: with or without #, or its page URL."},"location":{"type":"string","minLength":1,"description":"Posts at a location: numeric location id or URL (…/explore/locations/\u003cid\u003e/). One page: Instagram shows the rest only to signed-in users."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Attach from the same page, at no extra cost: posts (the creator's latest posts, ext.posts)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"linkedin","kind":"sns","operations":["profile","post","posts","comments","group","job","jobs"],"includes":[],"regions":["US"],"cost":{"comments":{"base":1,"max":1},"group":{"base":1,"max":1},"job":{"base":1,"max":1},"jobs":{"base":1,"max":1},"post":{"base":1,"max":1},"posts":{"base":1,"max":1},"profile":{"base":1,"max":1}},"params":{"comments":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"The post's comments: activity id, urn:li:activity:\u003cid\u003e, or URL."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Most comments to return (LinkedIn shows a post's top few)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"group":{"type":"object","properties":{"company":{"type":"string","minLength":1,"description":"Company vanity name (with or without company/, e.g. microsoft), or the company URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"job":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Numeric job id, urn:li:jobPosting:\u003cid\u003e, or the job URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"jobs":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Job search keywords (e.g. software engineer)."},"location":{"type":"string","minLength":1,"description":"Location name (e.g. United States). Default: worldwide."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Activity id, urn:li:activity:\u003cid\u003e, or the post URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Person vanity handle (with or without in/, e.g. williamhgates), or the profile URL."},"company":{"type":"string","minLength":1,"description":"Company vanity name (with or without company/, e.g. microsoft), or the company URL."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Most posts to return (LinkedIn shows the most recent few)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Person vanity handle (with or without in/, e.g. williamhgates), or the profile URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"naver","kind":"serp","operations":["search","suggestions","places","place","reviews"],"includes":[],"regions":["KR"],"cost":{"place":{"base":1,"max":1},"places":{"base":1,"max":1},"reviews":{"base":1,"max":10},"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"place":{"type":"object","properties":{"id":{"type":"string","pattern":"^\\d{4,20}$","description":"The place's id, as `places` returns it."},"url":{"type":"string","format":"uri","pattern":"(?:map\\.naver\\.com\\/(?:p|v5)\\/(?:entry\\/place|search\\/[^/?]+\\/place)|pcmap\\.place\\.naver\\.com\\/[a-z]+|m\\.place\\.naver\\.com\\/[a-z]+|naver\\.me)\\/(\\d{4,20})","description":"A Naver Map place URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"places":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["maps"],"description":"The map's place list (the only one Naver has)."},"location":{"type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?$","description":"Search as if from this point: `lat,lng`."},"near":{"type":"string","minLength":1,"maxLength":200,"description":"Search around this place name, or a `lat,lng` point."},"country":{"type":"string","enum":["KR"],"description":"The market, as an ISO 3166 country code."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 20, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"place":{"type":"string","pattern":"^\\d{4,20}$","description":"The place's id, as `places` returns it."},"sort":{"type":"string","enum":["relevant","newest"],"description":"Review order: Naver's recommended order (default) or newest first."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 10, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["KR"],"description":"The market, as an ISO 3166 country code."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 10, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["KR"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"naver-ai-brief","kind":"answers","operations":["answer"],"includes":["page"],"regions":["KR"],"cost":{"answer":{"base":1,"max":1}},"params":{"answer":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":16000,"description":"The question, as a person would type it."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries."},"include":{"anyOf":[{"type":"array","items":{"type":"string","enum":["details","page"]}},{"type":"string"}],"description":"`page`: also return the answer as a self-contained HTML page, in `page`."}},"required":["prompt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"naver-ai-tab","kind":"answers","operations":["answer"],"includes":["page"],"regions":["KR"],"cost":{"answer":{"base":1,"max":1}},"params":{"answer":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":16000,"description":"The question, as a person would type it."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries."},"conversation":{"type":"string","minLength":1,"maxLength":200,"description":"An earlier answer's `conversation.id`: ask a follow-up in the same conversation."},"include":{"anyOf":[{"type":"array","items":{"type":"string","enum":["details","page"]}},{"type":"string"}],"description":"`page`: also return the answer as a self-contained HTML page, in `page`."}},"required":["prompt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"reddit","kind":"sns","operations":["profile","profiles","post","posts","comments","group","groups"],"includes":[],"regions":["US"],"cost":{"comments":{"base":1,"max":3},"group":{"base":1,"max":2},"groups":{"base":1,"max":1},"post":{"base":1,"max":1},"posts":{"base":1,"max":1},"profile":{"base":1,"max":5},"profiles":{"base":1,"max":1}},"params":{"comments":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"A post's comments: post id, fullname (t3_…) or URL."},"comment":{"type":"string","minLength":1,"description":"With `post`: the comment whose replies to load (base36 id or t1_ fullname) — e.g. one whose `moreReplies` says replies were held back."},"username":{"type":"string","minLength":1,"description":"A user's comments: username or profile URL."},"sort":{"type":"string","enum":["confidence","top","new","controversial","old","qa","hot"],"description":"Order. post: confidence (Reddit's 'best'), top, new, controversial, old, qa · username: new, hot, top, controversial."},"period":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for sort top or controversial: hour, day, week, month, year or all."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Items per page, 1–100."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"group":{"type":"object","properties":{"community":{"type":"string","minLength":1,"description":"Community name (with or without r/) or URL."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Extra reads to attach under `ext`: rules (+1 unit). The community's style is always in `ext.style` (it comes with the community), so `style` is accepted and free."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"groups":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search communities by keyword."},"prefix":{"type":"string","minLength":1,"description":"Autocomplete: communities whose name starts with this (fast, one page)."},"username":{"type":"string","minLength":1,"description":"The communities a user is active in: username or profile URL."},"includeNsfw":{"type":"boolean","description":"prefix only: include over-18 communities."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Items per page, 1–100."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Post id (base36), fullname (t3_…), or the post URL (reddit.com, old.reddit.com, redd.it)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"A user's posts: username (with or without u/) or profile URL."},"community":{"type":"string","minLength":1,"description":"A community's posts: name (with or without r/) or URL. With `query`, narrows the search to it."},"query":{"type":"string","minLength":1,"description":"Search posts by keyword."},"ids":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Specific posts: ids, fullnames (t3_…) or URLs, 1–100 in one call."},"sort":{"type":"string","enum":["hot","new","top","rising","controversial","relevance","comments"],"description":"Order. username: new, hot, top, controversial · community: hot, new, top, rising, controversial · query: relevance, hot, top, new, comments · default feed: hot, new, top, rising."},"period":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for sort top or controversial: hour, day, week, month, year or all."},"country":{"type":"string","minLength":1,"description":"Default feed only: the country whose popular feed to read (ISO alpha-2)."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Items per page, 1–100."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Username, with or without u/, or the profile URL."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Extra reads to attach under `ext`: trophies (+1 unit)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profiles":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Keywords to search accounts for."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Items per page, 1–100."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"seznam","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["CZ"],"cost":{"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["CZ"],"description":"The market, as an ISO 3166 country code."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 10, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["CZ"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"shopify","kind":"marketplace","operations":["search","image-search","catalog","product","reviews"],"includes":[],"regions":["US"],"cost":{"catalog":{"base":1,"max":1},"image-search":{"base":1,"max":1},"product":{"base":1,"max":1},"reviews":{"base":1,"max":7},"search":{"base":1,"max":1}},"params":{"catalog":{"type":"object","properties":{"id":{"type":"string","minLength":3,"description":"The store: its host (comfrt.com) or any URL on it — a product, collection or home page link."},"collection":{"type":"string","minLength":1,"description":"Only this collection: its handle (best-sellers) or its URL. Omitted means the whole store — unless `id` is itself a collection page link, which lists that collection."},"page":{"type":"integer","minimum":1,"description":"1-based page number."},"pageSize":{"type":"integer","minimum":1,"maximum":250,"description":"Products per page, 1–250 (default 50)."},"cursor":{"type":"string","pattern":"^\\d{1,5}(\\.\\d{1,7})?$","description":"The previous page's `cursor`. Pass it for the next page; it also carries the store's total forward."},"currency":{"type":"string","description":"Presentment currency, ISO 4217."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"image-search":{"type":"object","properties":{"image":{"type":"object","properties":{"contentType":{"type":"string","pattern":"^image\\/(jpeg|png|webp|gif|avif)$"},"data":{"type":"string","minLength":1,"maxLength":6000000}},"required":["contentType","data"],"additionalProperties":false,"description":"Base64 image input for visual search; the image is the anchor and `query` narrows it — the reverse of `search`. Up to ~6MB of base64; supported types are jpeg, png, webp, gif and avif."},"query":{"type":"string","minLength":1,"description":"Optional text that refines the image — the reverse of `search`, where the query anchors the result. For example, a sneaker photo with `query=wool` returns wool sneakers rather than any sneaker of that shape."},"cursor":{"type":"string","description":"Opaque; comes from the previous response and carries the page index. Shopify pages by cursor rather than by number — this is the only paging knob, and `page` is refused by name."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."},"categoryId":{"type":"string","minLength":1,"description":"Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's `facets`."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"ratingMin":{"type":"number","minimum":0,"maximum":5,"description":"Lowest average star rating to return, on the marketplace's own 0-5 scale."},"condition":{"type":"string","enum":["new","used"],"description":"Item condition: `new` or `used`. `refurbished` is refused by name rather than folded into `used` — the catalog sells new and secondhand, and those are different claims."},"inStock":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false","1","0"]}],"description":"Only listings the marketplace reports as purchasable now."}},"required":["image"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"product":{"type":"object","properties":{"id":{"type":"string","minLength":3,"description":"A Shopify id rather than a global identifier: the composite `shop/handle`, e.g. us.giesswein.com/wool-sneaker-women. A search item's `id` is already in this form, and a full product URL is accepted too."},"currency":{"type":"string","description":"Presentment currency, ISO 4217."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"id":{"type":"string","minLength":3,"description":"The composite Shopify `shop/handle` — the same id `product` takes, not a global identifier. This is the one Shopify operation whose cost varies: a first page can cost more than 1, while a page fetched with `cursor` costs 1."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based starting page. Not every shop supports jumping to a page number; `cursor` works on every shop, so prefer it for paging."},"cursor":{"type":"string","description":"Opaque cursor from the previous response; the only paging knob that works on every shop, and it wins if `page` is sent too. A page fetched with a cursor costs 1."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Keywords to search for. Required: Shopify search always needs a keyword, which is also why Shopify has no keyword-less `browse`."},"cursor":{"type":"string","description":"Opaque; comes from the previous response and carries the page index. Shopify pages by cursor rather than by number — this is the only paging knob, and `page` is refused by name."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."},"categoryId":{"type":"string","minLength":1,"description":"Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's `facets`."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"ratingMin":{"type":"number","minimum":0,"maximum":5,"description":"Lowest average star rating to return, on the marketplace's own 0-5 scale."},"condition":{"type":"string","enum":["new","used"],"description":"Item condition: `new` or `used`. `refurbished` is refused by name rather than folded into `used` — the catalog sells new and secondhand, and those are different claims."},"inStock":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false","1","0"]}],"description":"Only listings the marketplace reports as purchasable now."}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"sogou","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["CN"],"cost":{"search":{"base":1,"max":10},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["CN"],"description":"The market, as an ISO 3166 country code."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"device":{"type":"string","enum":["desktop","mobile"],"description":"The page each tab is served as, and the only value it takes: mobile for web and news, desktop for images and videos."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default one page: 7-10 on web, 10 news, 48 images; at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["CN"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"threads","kind":"sns","operations":["profile","post","posts","comments"],"includes":[],"regions":["US"],"cost":{"comments":{"base":1,"max":1},"post":{"base":1,"max":1},"posts":{"base":1,"max":1},"profile":{"base":1,"max":1}},"params":{"comments":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"The post's replies: shortcode or URL."},"sort":{"type":"string","enum":["top","recent"],"description":"top (default) or recent."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Top order only. Attach from the same page, at no extra cost: post (the post itself, in `post`), related (the related threads Threads suggests beside it, ext.related)."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Post shortcode, or the post URL (…/@user/post/\u003ccode\u003e or …/t/\u003ccode\u003e)."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Attach from the same page, at no extra cost: comments (the first replies, top order, ext.comments), related (the related threads Threads suggests beside it, ext.related)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"type":{"type":"string","enum":["posts","reposts","replies"],"description":"username: the creator's threads (default), reposts or replies."},"query":{"type":"string","minLength":1,"description":"Search posts by keyword (one page)."},"hashtag":{"type":"string","minLength":1,"description":"Posts for a topic tag, with or without # (one page). Threads often answers a tag as a keyword match over post text and topic names; the page's `ext.matchedBy` says `tag` or `keyword`."},"sort":{"type":"string","enum":["top","recent"],"description":"query only: top (default) or recent."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"username only. Attach from the same page, at no extra cost: profile (the creator's profile, ext.profile)."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"userId":{"type":"string","minLength":1,"description":"Numeric Threads user id."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"username only. Attach from the same page, at no extra cost: posts (the creator's latest threads, ext.posts)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"tiktok","kind":"sns","operations":["profile","profiles","post","posts","comments","group","groups","media"],"includes":[],"regions":["US"],"cost":{"comments":{"base":1,"max":1},"group":{"base":1,"max":1},"groups":{"base":1,"max":2},"media":{"base":2,"max":2},"post":{"base":1,"max":1},"posts":{"base":1,"max":2},"profile":{"base":1,"max":1},"profiles":{"base":1,"max":2}},"params":{"comments":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"The video's comments: numeric video id or URL."},"comment":{"type":"string","minLength":1,"description":"With `post`: the comment whose replies to load (its id)."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Items per page, 1–50."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"group":{"type":"object","properties":{"hashtag":{"type":"string","minLength":1,"description":"A hashtag: its name, or its numeric id. A hashtag that is itself a number takes its # (#2024)."},"sound":{"type":"string","minLength":1,"description":"A sound: id or URL (…/music/-\u003cid\u003e)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"groups":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"userId":{"type":"string","minLength":1,"description":"Creator secUid. Pass it instead of a username to save the lookup (1 unit instead of 2)."},"type":{"type":"string","enum":["playlists"],"description":"playlists (the only list TikTok has)."},"limit":{"type":"integer","minimum":1,"maximum":30,"description":"Items per page, 1–30."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"media":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"The post whose file to download: numeric id or URL. A video gives its MP4, a photo post one picture."},"index":{"type":"integer","minimum":1,"maximum":100,"description":"Photo posts: which picture, 1-based (default 1)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Numeric video id, or the video URL / share link (vm.tiktok.com/…)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"userId":{"type":"string","minLength":1,"description":"Creator secUid. Pass it instead of a username to save the lookup (1 unit instead of 2)."},"type":{"type":"string","enum":["posts","reposts","likes"],"description":"username/userId: the creator's posts (default), reposts or likes."},"hashtag":{"type":"string","minLength":1,"description":"Videos under a hashtag: its name, or its numeric id (saves the lookup). A hashtag that is itself a number takes its # (#2024)."},"sound":{"type":"string","minLength":1,"description":"Videos using a sound: sound id or URL (…/music/-\u003cid\u003e)."},"playlist":{"type":"string","minLength":1,"description":"Videos in a playlist: id or URL (…/playlist/-\u003cid\u003e)."},"category":{"type":"string","minLength":1,"description":"Default feed only: explore category id (default 120)."},"limit":{"type":"integer","minimum":1,"maximum":30,"description":"Items per page, 1–30."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profiles":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Creator @handle (with or without @), or the profile URL."},"userId":{"type":"string","minLength":1,"description":"Creator secUid. Pass it instead of a username to save the lookup (1 unit instead of 2)."},"type":{"type":"string","enum":["followers","following"],"description":"Which list: followers or following."},"limit":{"type":"integer","minimum":1,"maximum":30,"description":"Items per page, 1–30."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"tiktokshop","kind":"marketplace","operations":["search","browse","categories","catalog","product","reviews"],"includes":[],"regions":["US"],"cost":{"browse":{"base":1,"max":1},"catalog":{"base":1,"max":1},"categories":{"base":1,"max":1},"product":{"base":1,"max":1},"reviews":{"base":1,"max":1},"search":{"base":1,"max":1}},"params":{"browse":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"description":"REQUIRED. The category to list, by the marketplace's own id."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["categoryId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"catalog":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"The store, by the marketplace's own id (on Shopify: its host or any URL on it)."},"cursor":{"type":"string","description":"The previous page's `cursor`, for the next 30 products."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"categories":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"description":"Omit for the root departments; give a category id to list its children."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"product":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"The marketplace's own product id, as carried by a search item."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"The product whose reviews to return."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Keywords to search for."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"tripadvisor","kind":"serp","operations":["places","place","reviews"],"includes":[],"regions":["US","GB","CA","AU","IN","IE","DE","FR","IT","ES","NL","BR","MX","JP","KR"],"cost":{"place":{"base":1,"max":1},"places":{"base":1,"max":4},"reviews":{"base":1,"max":5}},"params":{"place":{"type":"object","properties":{"id":{"type":"string","description":"The place's id, as `places` returns it (a Tripadvisor link is taken too)."},"url":{"type":"string","pattern":"tripadvisor\\.[a-z.]+\\/[A-Za-z_]+-g(\\d{1,12})(?:-d(\\d{3,12}))?(?:[-.])","description":"A Tripadvisor place link."},"country":{"type":"string","enum":["US","GB","CA","AU","IN","IE","DE","FR","IT","ES","NL","BR","MX","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"places":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"category":{"type":"string","enum":["all","restaurants","hotels","attractions","tours","destinations","airlines"],"description":"What to list: everything (default), restaurants, hotels, attractions (things to do, tours included), tours, destinations or airlines."},"location":{"type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?$","description":"Search as if from this point: `lat,lng`."},"near":{"type":"string","minLength":1,"maxLength":200,"description":"Search around this place name, or a `lat,lng` point."},"country":{"type":"string","enum":["US","GB","CA","AU","IN","IE","DE","FR","IT","ES","NL","BR","MX","JP","KR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"Interface language."},"limit":{"type":"integer","minimum":1,"maximum":120,"description":"Results wanted (default 30, at most 120). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"place":{"type":"string","description":"The place's id, as `places` returns it (a Tripadvisor link is taken too)."},"sort":{"type":"string","enum":["relevant","newest","detailed"],"description":"Review order: Tripadvisor's own (default), newest first, or the most detailed first."},"rating":{"type":"string","pattern":"^[1-5](,[1-5])*$","description":"Only reviews with these stars, e.g. `5` or `1,2`."},"visitType":{"type":"string","pattern":"^(families|couples|solo|business|friends)(,(families|couples|solo|business|friends))*$","description":"Only reviews by these travellers: families, couples, solo, business, friends (comma-separated)."},"months":{"type":"string","pattern":"^((1[0-2]|[1-9])|january|february|march|april|may|june|july|august|september|october|november|december)(,((1[0-2]|[1-9])|january|february|march|april|may|june|july|august|september|october|november|december))*$","description":"Only reviews of visits in these months, e.g. `6,7,8` or `june`."},"q":{"type":"string","minLength":1,"maxLength":2048,"description":"Only reviews that mention this text."},"language":{"type":"string","pattern":"^[a-z]{2}$","description":"Only reviews in this language — Tripadvisor counts its machine translations into it (each review says when it is one). All languages by default."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 20, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"walmart","kind":"marketplace","operations":["search","browse","categories","product","reviews"],"includes":[],"regions":["US"],"cost":{"browse":{"base":1,"max":1},"categories":{"base":1,"max":2},"product":{"base":1,"max":1},"reviews":{"base":1,"max":1},"search":{"base":1,"max":1}},"params":{"browse":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"description":"REQUIRED. The underscore-joined chain from a Walmart category URL, e.g. 3944_133251_1095191_1230614_1230478. A bare department or leaf id is refused with CATEGORY_NOT_BROWSABLE — use `categories` to walk down to a chain."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based results page. There is no `pageSize` — the results page is server-fixed at about 50 organic items — and no `cursor`, since paging here is by number."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"brands":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Brand names as the marketplace spells them, e.g. brands=Nike,Adidas."},"ratingMin":{"type":"number","minimum":0,"maximum":5,"description":"Lowest average star rating to return, on the marketplace's own 0-5 scale."},"facets":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"name":{"type":"string","minLength":1},"value":{"type":"string","minLength":1}},"required":["name","value"],"additionalProperties":false}]}}],"description":"Narrowings taken from a result's `facets`, e.g. facets=Color:Black. The escape hatch for filters the typed vocabulary has no word for; prefer a typed parameter where one exists."},"sort":{"type":"string","enum":["best_match","price_asc","price_desc","newly_listed","best_seller"],"description":"Result ordering: `best_match`, `price_asc`, `price_desc`, `newly_listed` or `best_seller`. Defaults to `best_match`, Walmart's own relevance ordering."}},"required":["categoryId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"categories":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"description":"Omit for the 42 departments; give a bare department id (`4171`) or an underscore chain to list that category's children. Unlike `browse`, a bare id is accepted here — descending from one is how a client reaches the chains `browse` takes."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"product":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Walmart's `usItemId`, all digits, as carried by a search item — chain straight in."},"seller":{"type":"string","pattern":"^\\d+$","description":"Walmart's numeric seller id (`seller.ext.catalogSellerId`, or `selectedSellerId` in a Walmart link; `0` is Walmart.com): the product's offer from that seller. A seller that does not sell the item gets Walmart's default offer, so compare the returned `seller.ext.catalogSellerId`."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Walmart's `usItemId`, all digits, as carried by a search item."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based review page; Walmart returns 10 reviews per page."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Keywords to search for. Required: image search is not available on Walmart, so a keyword query is the only way to search."},"page":{"type":"integer","exclusiveMinimum":0,"description":"1-based results page. There is no `pageSize` — the results page is server-fixed at about 50 organic items — and no `cursor`, since paging here is by number."},"region":{"type":"string","description":"Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price."},"categoryId":{"type":"string","minLength":1,"description":"Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's `facets`."},"priceMin":{"type":"number","minimum":0,"description":"Lowest price to return, in decimal major units."},"priceMax":{"type":"number","minimum":0,"description":"Highest price to return, in decimal major units."},"brands":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Brand names as the marketplace spells them, e.g. brands=Nike,Adidas."},"ratingMin":{"type":"number","minimum":0,"maximum":5,"description":"Lowest average star rating to return, on the marketplace's own 0-5 scale."},"facets":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"name":{"type":"string","minLength":1},"value":{"type":"string","minLength":1}},"required":["name","value"],"additionalProperties":false}]}}],"description":"Narrowings taken from a result's `facets`, e.g. facets=Color:Black. The escape hatch for filters the typed vocabulary has no word for; prefer a typed parameter where one exists."},"sort":{"type":"string","enum":["best_match","price_asc","price_desc","newly_listed","best_seller"],"description":"Result ordering: `best_match`, `price_asc`, `price_desc`, `newly_listed` or `best_seller`. Defaults to `best_match`, Walmart's own relevance ordering."}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"x","kind":"sns","operations":["profile","post","posts","group"],"includes":[],"regions":["US"],"cost":{"group":{"base":1,"max":1},"post":{"base":1,"max":1},"posts":{"base":1,"max":2},"profile":{"base":1,"max":1}},"params":{"group":{"type":"object","properties":{"community":{"type":"string","minLength":1,"description":"Numeric community id, or the community URL (x.com/i/communities/\u003cid\u003e)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Numeric post id, or the post URL (x.com/\u003chandle\u003e/status/\u003cid\u003e)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"@handle (with or without @), or the profile URL."},"userId":{"type":"string","minLength":1,"description":"Numeric user id. Pass it instead of a username to save the lookup."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Items per page, 1–100 — a hint only: X decides the page size (about 20, or ~100 for the most-liked list)."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"@handle (with or without @), or the profile URL."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"yahoo","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["US","GB","CA","DE","FR","IT","ES","IN","SG","PH","BR","MX","AR"],"cost":{"search":{"base":1,"max":9},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["US","GB","CA","DE","FR","IT","ES","IN","SG","PH","BR","MX","AR"],"description":"The market, as an ISO 3166 country code."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"safe":{"type":"string","enum":["on","off"],"description":"Safe search."},"limit":{"type":"integer","minimum":1,"maximum":60,"description":"Results wanted (default 7, at most 60). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","GB","CA","DE","FR","IT","ES","IN","SG","PH","BR","MX","AR"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"yahoo-japan","kind":"serp","operations":["search","suggestions"],"includes":[],"regions":["JP"],"cost":{"search":{"base":1,"max":10},"suggestions":{"base":1,"max":1}},"params":{"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["web","news","images","videos"],"description":"What to search: web results (default), news, images or videos."},"country":{"type":"string","enum":["JP"],"description":"The market, as an ISO 3166 country code."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 10, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["JP"],"description":"The market, as an ISO 3166 country code."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"yandex","kind":"serp","operations":["search","suggestions","places","place","reviews"],"includes":[],"regions":["US","RU","TR","KZ","BY","UA","UZ","DE","GB","FR"],"cost":{"place":{"base":1,"max":1},"places":{"base":1,"max":4},"reviews":{"base":1,"max":4},"search":{"base":1,"max":5},"suggestions":{"base":1,"max":1}},"params":{"place":{"type":"object","properties":{"id":{"type":"string","pattern":"^\\d{5,20}$","description":"The place's id, as `places` returns it."},"url":{"type":"string","pattern":"(?:yandex\\.[a-z.]+\\/maps\\/org\\/(?:[^/?#]+\\/)?|ymapsbm1:\\/\\/org\\?oid=)(\\d{5,20})","description":"A Yandex Maps organisation link."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"places":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"type":{"type":"string","enum":["maps"],"description":"The map's list of places (the only one Yandex has)."},"location":{"type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?$","description":"Search as if from this point: `lat,lng`."},"near":{"type":"string","minLength":1,"maxLength":200,"description":"Search around this place name, or a `lat,lng` point."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 20, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"reviews":{"type":"object","properties":{"place":{"type":"string","pattern":"^\\d{5,20}$","description":"The place's id, as `places` returns it."},"sort":{"type":"string","enum":["relevant","newest","highest","lowest"],"description":"Review order."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Results wanted (default 50, at most 200). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"search":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"image":{"type":"string","format":"uri","description":"An image URL: a reverse-image search instead of `q` (`type=image`)."},"type":{"type":"string","enum":["news","images","videos","image"],"description":"What to search: news, images, videos, or `image` for a reverse-image search. Yandex's web results are not offered."},"country":{"type":"string","enum":["US","RU","TR","KZ","BY","UA","UZ","DE","GB","FR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","enum":["en","ru"],"description":"Interface language: en (yandex.com, the default) or ru (yandex.ru)."},"device":{"type":"string","enum":["desktop","mobile"],"description":"Which page to read: the desktop (default) or the mobile one."},"timeRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from this past period."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Results wanted (default 20, at most 100). More than one page is charged per page."},"cursor":{"type":"string","minLength":1,"description":"The previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"suggestions":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2048,"description":"The query, search operators included."},"country":{"type":"string","enum":["US","RU","TR","KZ","BY","UA","UZ","DE","GB","FR"],"description":"The market, as an ISO 3166 country code."},"lang":{"type":"string","enum":["en","ru"],"description":"Interface language: en (yandex.com, the default) or ru (yandex.ru)."}},"required":["q"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}},{"id":"youtube","kind":"sns","operations":["profile","profiles","post","posts","comments","groups"],"includes":[],"regions":["US"],"cost":{"comments":{"base":1,"max":2},"groups":{"base":1,"max":2},"post":{"base":1,"max":1},"posts":{"base":1,"max":2},"profile":{"base":1,"max":3},"profiles":{"base":1,"max":1}},"params":{"comments":{"type":"object","properties":{"post":{"type":"string","minLength":1,"description":"The video's comments: video id or URL."},"comment":{"type":"string","minLength":1,"description":"A comment's replies: the comment's `moreReplies.cursor`."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"groups":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Channel @handle (with or without @), or the channel URL (/@handle, /channel/UC…, /c/…, /user/…)."},"userId":{"type":"string","minLength":1,"description":"Channel id (UC…)."},"type":{"type":"string","enum":["playlists"],"description":"playlists (a channel's playlists)."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"post":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Video id (11 chars), or the video URL (watch?v=…, youtu.be/…, /shorts/…)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"posts":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Channel @handle (with or without @), or the channel URL (/@handle, /channel/UC…, /c/…, /user/…)."},"userId":{"type":"string","minLength":1,"description":"Channel id (UC…)."},"query":{"type":"string","minLength":1,"description":"Search videos by keyword."},"hashtag":{"type":"string","minLength":1,"description":"Videos under a hashtag, with or without #."},"relatedTo":{"type":"string","minLength":1,"description":"A video id or URL; returns the videos YouTube recommends beside it."},"type":{"type":"string","enum":["videos","shorts","live","community"],"description":"username/userId: which channel tab — videos (default), shorts, live or community · query: videos (default) or shorts."},"country":{"type":"string","minLength":1,"description":"Default feed only: the country whose trending feed to read (ISO alpha-2, default US)."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profile":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Channel @handle (with or without @), or the channel URL (/@handle, /channel/UC…, /c/…, /user/…)."},"userId":{"type":"string","minLength":1,"description":"Channel id (UC…)."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"about: also read the channel's About panel — join date (createdAt), exact video count, total views, country and every link (+1 unit)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"profiles":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search channels by keyword."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor from the previous page's `cursor`. Pass it alone for the next page."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}],"pricing":{"currency":"USD","dailyBrackets":[{"fromUnits":0,"ratePct":100},{"fromUnits":1000,"ratePct":90},{"fromUnits":5000,"ratePct":80},{"fromUnits":10000,"ratePct":70},{"fromUnits":20000,"ratePct":60},{"fromUnits":30000,"ratePct":50}],"dayBoundary":"UTC","unitPrice":{"answers":"0.001200","image-translate":"0.003000","marketplace":"0.001000","serp":"0.001200"}}},"requestId":"66b06a6ccdcd4387bc237fe0e8b4c2cc","success":true}