answerline

{'type': 'object', 'required': ['prompt'], 'properties': {'gl': {'type': 'string', 'description': "Google's own name for the result-geography parameter, usable in place of `country`. Takes ISO 3166-1 alpha-2 codes, as `country` does, in upper or lower case (`us` or `US`), and the country has to be one this endpoint supports (list them with `GET /v1/countries`). Send either `country` or `gl`; if both are sent with differing values, the request fails with `400`."}, 'hl': {'type': 'string', 'description': "Interface language, in the format of Google's `hl` parameter (for example `en`, `de`, `pt-BR`). Case-insensitive free text; Google defines which codes exist. Takes precedence over the language Answerline infers from the country, which lets interface language and result geography differ."}, 'uule': {'type': 'string', 'description': "A ready-made Google UULE string for exact geo-targeting, in the location-name form (starting w+CAIQICI); the coordinate form (a+) is refused with a 400. Supply it when you already have an encoded UULE rather than a location name. Cannot be sent together with 'location' — pass only one of the two."}, 'device': {'enum': ['desktop', 'mobile'], 'type': 'string', 'default': 'desktop', 'description': 'Type of device the results are fetched for'}, 'prompt': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'Prompt submitted to AI Mode'}, 'country': {'type': 'string', 'description': 'Code of the country or region used to localize the response'}, 'include': {'type': 'object', 'default': {'html': False, 'markdown': False, 'expandProducts': False}, 'properties': {'html': {'type': 'boolean', 'default': False, 'description': 'Return a link to the complete HTML of the response'}, 'markdown': {'type': 'boolean', 'default': False, 'description': 'Add a markdown version of the response to the result'}, 'googleGoto': {'type': 'boolean', 'default': False, 'deprecated': True, 'description': 'Has had no effect since 8th September 2026. Each redirect link is now always returned as `redirectLink` next to its target, so you get both without setting this flag. Requests that still include it are handled as though it were omitted.'}, 'expandProducts': {'type': 'boolean', 'default': False, 'description': "Look up merchant offers for the response's product clusters and return them in 'result.productResults'. Clusters found in both inline products and shopping cards count once, and no more than 6 are expanded per request. Each returned cluster costs +1 credit, up to +6 in total. Disabled by default."}}, 'description': 'Flags that add extra output formats to the response (optional)', 'additionalProperties': False}, 'location': {'type': 'string', 'description': "Location name in Google's canonical form, used for geo-targeted results, written comma-separated as 'City,Region,Country' (https://developers.google.com/google-ads/api/reference/data/geotargets lists every supported location, ~100,000 in all). Combine it with 'country' to target a specific city. Cannot be combined with 'uule'; send only one of the two."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['prompt', 'country'], 'properties': {'state': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'maxLength': 2, 'minLength': 2, 'description': 'State code for targeting below the country level (e.g., "CA"; "DC" included). Allowed only when country is "US". Served for Gemini; on a model that cannot place a state yet, a request that includes it is rejected as a validation error and is not charged.'}, 'legacy': {'type': 'boolean', 'default': False, 'description': "Accepted for compatibility with clients that ask for ChatGPT's older desktop interface. Not served yet: the answer arrives in the same shape whatever its value. Default: false."}, 'prompt': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'Prompt submitted to ChatGPT. ChatGPT takes up to 2,000 characters; a longer prompt is refused with a 400.'}, 'country': {'type': 'string', 'description': 'Code of the country or region used to localize the response'}, 'include': {'type': 'object', 'default': {'ads': False, 'html': False, 'markdown': False, 'shopping': False, 'rawResponse': False, 'searchQueries': False}, 'required': [], 'properties': {'ads': {'type': 'boolean', 'default': False, 'description': 'Return ads that ChatGPT shows in its response'}, 'html': {'type': 'boolean', 'default': False, 'description': 'Return a link to the complete HTML of the response'}, 'markdown': {'type': 'boolean', 'default': False, 'description': 'Add a markdown version of the response to the result'}, 'shopping': {'type': 'boolean', 'default': False, 'description': 'Return shopping cards plus products shown inline, with their prices and offers. Costs +2 credits on top of the base cost (the same +2 covers rawResponse, searchQueries and ads — turning on one of them or several still adds only +2).'}, 'rawResponse': {'type': 'boolean', 'default': False, 'description': 'Return the unprocessed response payload from ChatGPT'}, 'searchQueries': {'type': 'boolean', 'default': False, 'description': 'Return the fan-out queries ChatGPT issued while producing the response'}}, 'description': 'Flags that add extra output formats to the response (optional)', 'additionalProperties': False}, 'disableWebSearch': {'type': 'boolean', 'default': False, 'description': "Leave ChatGPT's web search unforced. Answerline then returns whatever ChatGPT answers by itself, searching the web only if ChatGPT chooses to, so `result.sources`, `result.citationPills` and `result.searchQueries` are frequently empty. Default is false, meaning every request forces web search."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['prompt', 'country'], 'properties': {'state': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'maxLength': 2, 'minLength': 2, 'description': 'State code for targeting below the country level (e.g., "CA"; "DC" included). Allowed only when country is "US". Served for Gemini; on a model that cannot place a state yet, a request that includes it is rejected as a validation error and is not charged.'}, 'prompt': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'Prompt submitted to Copilot'}, 'country': {'type': 'string', 'description': 'Code of the country or region used to localize the response'}, 'include': {'type': 'object', 'default': {'html': False, 'markdown': False, 'rawResponse': False}, 'properties': {'html': {'type': 'boolean', 'default': False, 'description': 'Return a link to the complete HTML of the response'}, 'markdown': {'type': 'boolean', 'default': False, 'description': 'Add a markdown version of the response to the result'}, 'rawResponse': {'type': 'boolean', 'default': False, 'description': 'Return the unprocessed stream of response events'}}, 'description': 'Flags that add extra output formats to the response (optional)', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': False}

{'type': 'object', 'required': ['prompt', 'country'], 'properties': {'state': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'maxLength': 2, 'minLength': 2, 'description': 'State code for targeting below the country level (e.g., "CA"; "DC" included). Allowed only when country is "US". Served for Gemini; on a model that cannot place a state yet, a request that includes it is rejected as a validation error and is not charged.'}, 'prompt': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'Prompt submitted to Gemini. Gemini takes up to 2,000 characters; a longer prompt is refused with a 400.'}, 'country': {'type': 'string', 'description': 'Code of the country or region used to localize the response'}, 'include': {'type': 'object', 'default': {'html': False, 'markdown': False, 'rawResponse': False}, 'required': [], 'properties': {'html': {'type': 'boolean', 'default': False, 'description': 'Not available for Gemini: its answer is read without a page to snapshot, so `true` is refused with a validation error.'}, 'markdown': {'type': 'boolean', 'default': False, 'description': 'Add a markdown version of the response to the result'}, 'rawResponse': {'type': 'boolean', 'default': False, 'description': 'Return the unprocessed stream of response events'}}, 'description': 'Flags that add extra output formats to the response (optional)', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'gl': {'type': 'string', 'description': "Google's own name for the result-geography parameter, usable in place of `country`. Takes ISO 3166-1 alpha-2 codes, as `country` does, in upper or lower case (`us` or `US`), and the country has to be one this endpoint supports (list them with `GET /v1/countries`). Send either `country` or `gl`; if both are sent with differing values, the request fails with `400`."}, 'hl': {'type': 'string', 'description': "Interface language, in the format of Google's `hl` parameter (for example `en`, `de`, `pt-BR`). Case-insensitive free text; Google defines which codes exist. Takes precedence over the language Answerline infers from the country, which lets interface language and result geography differ."}, 'url': {'type': 'string', 'format': 'uri', 'description': "A full URL of a Google web search, executed as-is in place of a request assembled from 'query' plus the targeting fields. It has to be absolute and http(s), hosted on one of Google's web search domains (google.com, google.co.uk, www.google.de, ...), with '/search' as its path and a 'q' that is not empty. Cannot be combined with 'query', 'location', 'uule' or 'pages', since the URL already determines them. It may carry only these query parameters: 'q', 'gl', 'num' (treated as result depth), 'hl' and 'uule'; a URL with any other (such as 'start', 'tbs' or 'safe') is refused with a 400. A URL containing 'tbm' is refused: it points at a Google vertical that has a separate endpoint and price (for tbm=nws, call POST /v1/monitor/google/news)."}, 'uule': {'type': 'string', 'description': "A ready-made Google UULE string for exact geo-targeting, in the location-name form (starting w+CAIQICI); the coordinate form (a+) is refused with a 400. Supply it when you already have an encoded UULE rather than a location name. Cannot be sent together with 'location' — pass only one of the two. Not allowed together with 'url'; in that case add 'uule' to the URL's query string."}, 'pages': {'type': 'integer', 'default': 1, 'maximum': 10, 'minimum': 1, 'description': "How many pages of search results to retrieve (1-10). Not allowed together with 'url' — when 'url' is given, depth is taken from the URL's 'num' parameter (rounded up to full 10-result pages, at most 10 pages)."}, 'query': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': "Query to run on Google. Mandatory when 'url' is not given; send one or the other, never both."}, 'device': {'enum': ['desktop', 'mobile', 'ios', 'android'], 'type': 'string', 'default': 'desktop', 'description': "Device to run the search on. 'desktop' gives the desktop SERP, while 'ios' (Safari on an iPhone), 'android' (Chrome on an Android phone) and 'mobile' (same as 'android') each give the mobile SERP."}, 'country': {'type': 'string', 'description': "Country for localized search results, as an ISO 3166-1 alpha-2 code. Mandatory in the standard request form. If you send 'url' instead, the country is taken from the URL's 'gl' parameter — set it yourself to override that value, or when the URL carries no 'gl'."}, 'include': {'type': 'object', 'default': {'html': False}, 'properties': {'html': {'type': 'boolean', 'default': False, 'description': 'Return the unprocessed HTML page from Google Search'}, 'aioverview': {'type': 'object', 'default': {'markdown': False}, 'properties': {'markdown': {'type': 'boolean', 'default': False, 'description': 'Return the AI Overview in markdown form'}}, 'description': "Add Google's AI Overview to the response", 'additionalProperties': False}, 'googleGoto': {'type': 'boolean', 'default': False, 'deprecated': True, 'description': 'Has had no effect since 8th September 2026. Each redirect link is now always returned as `redirectLink` next to its target, so you get both without setting this flag. Requests that still include it are handled as though it were omitted.'}, 'paaAioverview': {'type': 'boolean', 'default': False, 'description': "Fill People Also Ask items of the AI Overview type with markdown content and their sources. Charges no credits past the AI Overview add-on's +2; every hydrated item needs one more fetch (usually 1-2 on a page), which makes responses slower."}}, 'description': 'Flags that add extra data to the response (optional)', 'additionalProperties': False}, 'location': {'type': 'string', 'description': "Location name in Google's canonical comma-separated form 'City,Region,Country' (roughly 100,000 accepted locations are listed at https://developers.google.com/google-ads/api/reference/data/geotargets). Combine with 'country' to target a specific city. Cannot be sent together with 'uule' — choose one of the two. Not allowed when 'url' is set."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query'], 'properties': {'gl': {'type': 'string', 'description': "Google's own name for the result-geography parameter, usable in place of `country`. Takes ISO 3166-1 alpha-2 codes, as `country` does, in upper or lower case (`us` or `US`), and the country has to be one this endpoint supports (list them with `GET /v1/countries`). Send either `country` or `gl`; if both are sent with differing values, the request fails with `400`."}, 'hl': {'type': 'string', 'description': "Interface language, in the format of Google's `hl` parameter (for example `en`, `de`, `pt-BR`). Case-insensitive free text; Google defines which codes exist. Takes precedence over the language Answerline infers from the country, which lets interface language and result geography differ."}, 'pages': {'type': 'integer', 'default': 1, 'maximum': 10, 'minimum': 1, 'description': 'How many pages of news results to retrieve (1-10)'}, 'query': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'Query to run on Google News'}, 'device': {'enum': ['desktop', 'mobile', 'ios', 'android'], 'type': 'string', 'default': 'desktop', 'description': 'Device to run the search on. Not served for Google News yet: its results are read without a device, and a request that sets one is refused with a 400.'}, 'country': {'type': 'string', 'description': 'Country for localized news, as an ISO 3166-1 alpha-2 code. Google News publishes an edition in 71 countries, listed at https://answerline.dev/docs/coverage#countries; a request for another country is refused with a 400.'}, 'include': {'type': 'object', 'default': {'html': False}, 'properties': {'html': {'type': 'boolean', 'default': False, 'description': 'Not available for Google News: results are read from the news feed, with no page to snapshot, so `true` is refused with a validation error.'}}, 'description': 'Flags that add extra data to the response (optional)', 'additionalProperties': False}}, 'additionalProperties': False}