learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:en","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:English","type":"string"},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationChatGptLlmResponsesLiveRequestInfo":{"properties":{"force_web_search":{"description":"force AI agent to use web search
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response
Note #2: not supported in reasoning models","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value for reasoning models (e.g., reasoning is true in the Models endpoint): 1024;
minimum value for non-reasoning models: 16;
maximum value: 4096;
default value: 2048
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gpt-4.1 is specified, the gpt-4.1-2025-04-14 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 2
default value: 0.94
Note: not supported in reasoning models","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: 0.92
Note: top_p cannot be used together with temperature in the same request","type":["number","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search
optional field
when enabled, the AI model can access and cite current web information;
default value: false;
Note: refer to the Models endpoint for a list of models that support web_search;","type":["boolean","null"]},"web_search_city":{"description":"city name of the location
optional field
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model will search the web from the country you specify;
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationChatGptLlmResponsesTaskPostRequestInfo":{"properties":{"force_web_search":{"description":"force AI agent to use web search
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response
Note #2: not supported in reasoning models","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value for reasoning models (e.g., reasoning is true in the Models endpoint): 1024;
minimum value for non-reasoning models: 16;
maximum value: 4096;
default value: 2048","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gpt-4.1 is specified, the gpt-4.1-2025-04-14 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"system_message":{"description":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior;
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data array of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 2
default value: 0.94
Note: not supported in reasoning models","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: 0.92
Note: top_p cannot be used together with temperature in the same request","type":["number","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search
optional field
when enabled, the AI model can access and cite current web information;
default value: false;
Note: refer to the Models endpoint for a list of models that support web_search;","type":["boolean","null"]},"web_search_city":{"description":"city name of the location
optional field
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model will search the web from the country you specify;
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedRequestInfo":{"properties":{"force_web_search":{"description":"force AI agent to use web search
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlRequestInfo":{"properties":{"expand_citations":{"description":"return expanded citation bar in HTML results
optional field
to enable this parameter, force_web_search must also be enabled;
when enabled, the endpoint will return HTML data from the expanded citation bar;
default value: false","type":["boolean","null"]},"force_web_search":{"description":"force AI agent to use web search
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/locations
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationChatGptLlmScraperTaskPostRequestInfo":{"properties":{"expand_citations":{"description":"return expanded citation bar in HTML results
optional field
to enable this parameter, force_web_search must also be enabled;
when enabled, the HTML endpoint will return data from the expanded citation bar;
default value: false","type":["boolean","null"]},"force_web_search":{"description":"force AI agent to use web search
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languagesn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype
required field if you specify postback_url
corresponds to the function you used for setting a task
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationClaudeLlmResponsesLiveRequestInfo":{"properties":{"force_web_search":{"description":"force AI agent to use web search
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1;
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1025","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if claude-opus-4-0 is specified, the claude-opus-4-20250514 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior;
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 1
default value: 0.7
Note: temperature cannot be used together with top_p in the same request","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: null
Note: top_p cannot be used together with temperature in the same request","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1025
Note #2: if set to true, force_web_search must be set to false
Note #3: if set to true, the temperature and top_p cannot be used","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]},"web_search_city":{"description":"city name of the location used for searching the web
optional field
","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location used for searching the web
optional field
possible values: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationClaudeLlmResponsesTaskPostRequestInfo":{"properties":{"force_web_search":{"description":"force AI agent to use web search
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1;
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1025","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if claude-opus-4-0 is specified, the claude-opus-4-20250514 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"system_message":{"description":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior;
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 1
default value: 0.7
Note: temperature cannot be used together with top_p in the same request","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: null
Note: top_p cannot be used together with temperature in the same request","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1025
Note #2: if set to true, force_web_search must be set to false
Note #3: if set to true, the temperature and top_p cannot be used","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]},"web_search_city":{"description":"city name of the location used for searching the web
optional field
","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location used for searching the web
optional field
possible values: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationGeminiLlmResponsesLiveRequestInfo":{"properties":{"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1024","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gemini-1.5-pro is specified, the gemini-1.5-pro-002 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behavior
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse
lower values make output more focused
minimum value: 0
maximum value: 2
default value: 1.3","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection
minimum value: 0
maximum value: 1
default value: 0.9","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1024
Note #2: for Gemini Pro models, the use_reasoning will automatically be set to true","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationGeminiLlmResponsesTaskPostRequestInfo":{"properties":{"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1;
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1024","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gemini-1.5-pro is specified, the gemini-1.5-pro-002 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"system_message":{"description":"instructions for the AI behavior
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse
lower values make output more focused
minimum value: 0
maximum value: 2
default value: 1.3","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection
minimum value: 0
maximum value: 1
default value: 0.9","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1024
Note #2: for Gemini Pro models, the use_reasoning will automatically be set to true","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedRequestInfo":{"properties":{"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”
learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example: enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example: English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:2840","type":"integer"},"location_coordinate":{"description":"
GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_code
location_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199 (mm)
the maximum value for \"radius\": 199999 (mm)
example:
53.476225,-2.243572,200
location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locationsUnited States","type":"string"},"tag":{"description":"user-defined task identifiertag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlRequestInfo":{"properties":{"expand_citations":{"description":"return expanded citation bar in HTML resultsfalse","type":["boolean","null"]},"keyword":{"description":"keywordkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:2840","type":"integer"},"location_coordinate":{"description":"
GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_code
location_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199 (mm)
the maximum value for \"radius\": 199999 (mm)
example:
53.476225,-2.243572,200
location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locationsUnited States","type":"string"},"tag":{"description":"user-defined task identifiertag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationGeminiLlmScraperTaskPostRequestInfo":{"properties":{"expand_citations":{"description":"return expanded citation bar in HTML resultsfalse","type":["boolean","null"]},"keyword":{"description":"keywordkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:2840","type":"integer"},"location_coordinate":{"description":"
GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_code
location_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199 (mm)
the maximum value for \"radius\": 199999 (mm)
example:
53.476225,-2.243572,200
location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locationsUnited States","type":"string"},"pingback_url":{"description":"notification URL of a completed task$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype
required field if you specify postback_url
corresponds to the function you used for setting a task
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"search language code default value: default value: you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: you can add several filters at once (8 filters maximum) the full list of possible filters is available here. The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_brand_categories":{"description":"array of brand categories to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_brand_categories":{"description":"array of brand_categories to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_brands":{"description":"array of brands to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_brands":{"description":"array of brands to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_domains":{"description":"array of domains to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_domains":{"description":"array of domains to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_pages":{"description":"array of page URLs to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_pages":{"description":"array of pages to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority you can receive the list of available filters_by making a separate request to note that you can set no more than three sorting rules in a single request Your account will be billed per each SERP containing up to 25 results; learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority you can receive the list of available filters_by making a separate request to note that you can set no more than three sorting rules in a single request learn more about rules and limitations of default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_indirect_links":{"description":"indicates if indirect links to the default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_subdomains":{"description":"indicates if the subdomains of the default value: default value: default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"search_after_token":{"description":"token for subsequent requests default value: today's date -(minus) one month; date format: default value: today's date -(minus) one month; date format: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"limit":{"description":"the maximum number of returned domains you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_indirect_links":{"description":"indicates if indirect links to the default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_subdomains":{"description":"indicates if the subdomains of the default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_indirect_links":{"description":"indicates if indirect links to the default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_indirect_links":{"description":"indicates if indirect links to the default value: default value: default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_indirect_links":{"description":"indicates if indirect links to the default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: The full list of possible filters is available here.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_indirect_links":{"description":"indicates if indirect links to the default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier default value: default value: you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier minimum value: note: for for example, if you specify: if there is no data for a certain minimum value: note: for for example, if you specify: if there is no data for a certain you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article","type":["string","null"]},"tag":{"description":"user-defined task identifier Note: if you use this field, your account will be charged two times the standard rate for tasks involving the Google Reviews API","type":"string"},"depth":{"description":"parsing depth Your account will be billed per each SERP containing up to 20 results; learn more about rules and limitations of Note: if you use this field, your account will be charged three times the standard rate for tasks involving the Google Reviews API","type":"string"},"language_code":{"description":"search engine language code learn more on our Help Center","type":["string","null"]},"place_id":{"description":"identifier of the business entity in Google Maps Note: if you use this field, your account will be charged two times the standard rate for tasks involving the Google Reviews API","type":"string"},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority set the following value if you want to include one 14-years-old child: set the following value if you want to include one 14-years-old child: set the following value if you want to include one 14-years-old child: learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"prices_date_range":{"description":"predefined period for retrieving daily price data learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority this field can also be used to pass the following parameters: example: learn more about the learn more about rules and limitations of this field can also be used to pass the following parameters: example: learn more about the learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about the learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority this field can also be used to pass the following parameters: example: learn more about the learn more about rules and limitations of this field can also be used to pass the following parameters: example: learn more about the learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"place_id":{"description":"identifier of the business entity in Google Maps learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority Your account will be billed per each SERP containing up to 30 results; learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority [\"content_info.text_category\",\"has\",10994]]] you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works in this Help Center article","type":["string","null"]},"search_mode":{"description":"results grouping type [\"content_info.text_category\",\"has\",10994]]] learn more about rules and limitations of you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works in this Help Center article","type":["string","null"]},"search_mode":{"description":"results grouping type [\"content_info.text_category\",\"has\",10994]]] learn more about rules and limitations of you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works in this Help Center article","type":["string","null"]},"search_mode":{"description":"results grouping type [\"content_info.text_category\",\"has\",10994]]] learn more about rules and limitations of you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works in this Help Center article","type":["string","null"]},"search_mode":{"description":"results grouping type [\"content_info.text_category\",\"has\",10994]]] learn more about rules and limitations of you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works in this Help Center article","type":["string","null"]},"sentiments_connotation_threshold":{"description":"sentiment connotation threshold learn more about rules and limitations of for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"intersection_mode":{"description":"mode for finding asin intersections Note: all letters in ASIN code must be specified in uppercase format; for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords learn more about rules and limitations of for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code default rule: for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code default rule: for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code learn more about rules and limitations of Note: if the possible values: learn more about how clickstream-based metrics are calculated in this help center articlen","type":["boolean","null"]},"include_subcategories":{"description":"indicates if the subcategories will be included in the search Note: if the possible values: default rule: learn more about rules and limitations of example: for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords learn more about how clickstream-based metrics are calculated in this help center articlen","type":["boolean","null"]},"intersecting_domains":{"description":"additional domains for improving results accuracy Note: if the possible values: if you specify default rule: Note: if the possible values: note that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn't contain such keywords and cannot return data on them learn more about rules and limitations of Note: historical clickstream data is available from 2024/05 (May, 2024); [\"keyword_info.high_top_of_page_bid\",\"<=\",0.5]]] learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword learn more about rules and limitations of default rule: note that you can set no more than three sorting rules in a single request learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword note that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn't contain such keywords and cannot return data on them learn more about rules and limitations of learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_seed_keyword":{"description":"include data for the seed keyword learn more about rules and limitations of for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"language code learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword default rule: if you want to get the keywords a particular webpage ranks for, you can use a learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"item_types":{"description":"display results by item type Note: if the possible values: number of the returned results depends on the value you set in this field [\"keyword_info.high_top_of_page_bid\",\"<=\",0.5]]] learn more about rules and limitations of example: learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"item_types":{"description":"display results by item type Note: if the possible values: default rule: learn more about rules and limitations of possible values: learn more about rules and limitations of learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"item_types":{"description":"display results by item type Note: if the possible values: default rule: [\"keyword_info.high_top_of_page_bid\",\"<=\",0.5]]] learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword for more information about filters, please refer to Domain Analytics Technologies API - Filters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"keywords":{"description":"target keywords in the domain's title, description or meta keywords learn more about rules and limitations of for more information about filters, please refer to Domain Analytics Technologies API - Filters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"groups":{"description":"ids of the target technology groups learn more about rules and limitations of for more information about filters, please refer to Domain Analytics Technologies API - Filters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"groups":{"description":"ids of the target technology groups learn more about rules and limitations of if you use this field, you can receive the list of available industry names with industry_id by making a separate request to the https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries example: if you use this field, you can receive the list of available job function names with job_function_id by making a separate request to the https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions example: if you use this field, you can receive the list of available industry names with industry_id by making a separate request to the https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries example: if you use this field, you can receive the list of available job function names with job_function_id by making a separate request to the https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions example: learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"tag":{"description":"user-defined task identifier Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"date_to":{"description":"ending date of the time range Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"device":{"description":"device type learn more about rules and limitations of Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"date_to":{"description":"ending date of the time range Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"device":{"description":"device type learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"search_partners":{"description":"Bing search partners type Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"date_to":{"description":"ending date of the time range Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"device":{"description":"device type Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"date_to":{"description":"ending date of the time range Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"device":{"description":"device type learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"search_partners":{"description":"Bing search partners type date format: Note 2: if if you specify the with value Note: we do not recommend using a custom time range Note 2: if if you specify the with value default value: Note: we do not recommend using a custom time range Note 2: if if you specify the with value minimum value: two years back from today’s date; Note: we do not recommend using a custom time range Note 2: if if you specify the with value learn more about rules and limitations of possible values: default value: learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"tag":{"description":"user-defined task identifier Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"date_to":{"description":"ending date of the time range Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"device":{"description":"device type learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"search_partners":{"description":"Bing search partners type learn more about rules and limitations of Note: certain symbols and characters (e.g., UTF symbols, emojis) are not allowed learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"sort_by":{"description":"results sorting parameters learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"search_partners":{"description":"include Google search partners learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"search_partners":{"description":"include Google search partners learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"search_partners":{"description":"include Google search partners Note: to obtain Note: keywords cannot consist of a combination of the following characters: Note: to obtain learn more about rules and limitations of Note: to obtain Note: keywords cannot consist of a combination of the following characters: Note: to obtain learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"tag":{"description":"user-defined task identifier learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"price_max":{"description":"maximum product price learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"price_max":{"description":"maximum product price learn more on our Help Center","type":["string","null"]},"postback_data":{"type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority possible values: Note: to use this parameter, set Note: to use this parameter, set minimum value, in pixels: Note: to use this parameter, set minimum value: Note: to use this parameter, set minimum value, in pixels: if you use this field, note: you can set up to 1000 The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task if you ignore this field, we will return data for all audits; Note: that some audits do not belong to a specific category and are stand-alone page quality measurements; in general, there can be several use cases: 1. if you ignore 2. if you specify a category, you can use this field to additionally receive audits that do not belong to the category(-ies) you specified you can get the full list of possible audits here","items":{"type":"string"},"type":["array","null"]},"browser_cpu_throttling_multiplier":{"description":"browser CPU throttling multiplier if you ignore this field, we will return data for all categories unless you specify possible values: note that some audits do not belong to a specific category and are stand-alone page quality measurements in general, there can be several use cases: 1. if you ignore 2. if you specify a category, you can use this field to additionally receive audits that do not belong to the category(-ies) you specified you can get the full list of possible audits here","items":{"type":"string"},"type":["array","null"]},"browser_cpu_throttling_multiplier":{"description":"browser CPU throttling multiplier possible values: The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task possible values: Note: in this endpoint, the minimum value, in pixels: minimum value: minimum value, in pixels: The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task the following filtering parameter is supported: examples: The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task learn more on our Help Center","type":["string","null"]},"priority_urls":{"description":"urls to be crawled bypassing the queue The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task learn more about rules and limitations of example: example: learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set calculate pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: provider usage may increase for using this parameter parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl default value: max value: Note: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified target domain, subdomain, or webpage to get results for optional field a domain or a subdomain should be specified without note that the results of you can also use a wildcard (‘*’) character to specify the search pattern in SERP and narrow down the results; examples: direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl default value: max value: Note: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl default value: max value: Note: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified target domain, subdomain, or webpage to get results for optional field a domain or a subdomain should be specified without note that the results of you can also use a wildcard (‘*’) character to specify the search pattern in SERP and narrow down the results; examples: direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set calcualte pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: provider usage may increase for using this parameter parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl default value: max value: Note: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"search_param":{"description":" additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine location code optional field if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: Note: if you don't specify GPS coordinates of a location optional field if you use this field, you don't need to specify example: Note: if you don't specify full name of search engine location optional field if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: Note: if you don't specify notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the function you used for setting a task possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified advertiser identifiers required field if you can specify the maximum of 25 values in this array; starting date of the time range optional field required field if date format: minimum value: 2018-05-31 maximum value: today's date example: ending date of the time range optional field required field if date format: minimum value: 2018-05-31 maximum value: today's date example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 40 may result in additional charges if the search engine returns more than 40 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"format":{"description":" ad format optional field possible values: search engine location code optional field if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: Note: if you don't specify GPS coordinates of a location optional field if you use this field, you don't need to specify example: Note: if you don't specify full name of search engine location optional field if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: Note: if you don't specify notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center advertising platform optional field possible values: default value: postback_url datatype required field if you specify corresponds to the function you used for setting a task possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified domain name required field if domain name associated with an advertiser account browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set calculate pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: if set to device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their Note: check Google Search Help for the list of countries where AI Mode is currently available GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 9z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 4z the maximum value for \"zoom\": 18z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their Note: check Google Search Help for the list of countries where AI Mode is currently available device operating system optional field if you specify default value: if you specify default value: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set calculate pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: if set to device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their Note: check Google Search Help for the list of countries where AI Mode is currently available GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 9z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 4z the maximum value for \"zoom\": 18z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their Note: check Google Search Help for the list of countries where AI Mode is currently available device operating system optional field if you specify default value: if you specify default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the function you used for setting a task possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified search client for autocomplete optional field autocomplete results may differ depending on the search client; possible values: search bar cursor pointer optional field the horizontal numerical position of the cursor pointer within the keyword in the search bar; by modifying the position of the cursor pointer, you will obtain different autocomplete suggestions for the same seed keyword; minimal value: default value: the number of the last character of the specified example: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified search client for autocomplete optional field autocomplete results may differ depending on the search client; possible values: search bar cursor pointer optional field the horizontal numerical position of the cursor pointer within the keyword in the search bar; by modifying the position of the cursor pointer, you will obtain different autocomplete suggestions for the same seed keyword; minimal value: default value: the number of the last character of the specified example: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.e., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified ID of the dataset required field you can find dataset ID in the dataset URL or example: device type optional field return results for a specific device type possible value: search engine language code optional field if you use this field, you don't need to specify possible value: full name of search engine language optional field if you use this field, you don't need to specify possible value: device operating system optional field possible values: default value: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified ID of the dataset required field you can find dataset ID in the dataset URL or example: device type optional field return results for a specific device type possible value: search engine language code optional field if you use this field, you don't need to specify possible value: full name of search engine language optional field if you use this field, you don't need to specify possible value: device operating system optional field choose from the following values: default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible value: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified parsing depth optional field number of results in SERP default value: max value: Setting depth above 20 may result in additional charges if the search engine returns more than 20 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type possible value: file formats of the dataset optional field possible values: indicates whether displayed datasets are free optional field possible values: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code optional field if you don't specify if you use this field, you don't need to specify possible value: full name of search engine language optional field if you use this field, you don't need to specify possible value: last time the dataset was updated optional field possible values: device operating system optional field choose from the following values: default value: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified dataset topics optional field possible values: usage rights of the dataset optional field possible values: parsing depth optional field number of results in SERP default value: max value: Setting depth above 20 may result in additional charges if the search engine returns more than 20 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically;","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type possible value: file formats of the dataset optional field possible values: indicates whether displayed datasets are free optional field possible values: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code optional field possible value: full name of search engine language optional field if you use this field, you don't need to specify possible value: last time the dataset was updated optional field possible values: device operating system optional field possible values: default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server only value: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified dataset topics optional field possible values: usage rights of the dataset optional field possible values: device type optional field return results for a specific device type possible value: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: financial news filters optional field possible values: default value: Note: if you specify device operating system optional field possible values: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified device type optional field possible value: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: financial news filters optional field possible values: default value: device operating system optional field possible values: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified device type optional field return results for a specific device type possible value: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: financial news filters optional field possible values: default value: Note: if you specify device operating system optional field possible values: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values:: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified device type optional field return results for a specific device type possible value: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: type of google finance market optional field possible values: default value: device operating system optional field possible values: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified device type optional field possible value: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: type of google finance market optional field possible values: default value: device operating system optional field possible values: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified device type optional field return results for a specific device type possible value: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: type of google finance market optional field possible values: default value: device operating system optional field possible values: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values:: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified device type optional field return results for a specific device type possible value: ticker or stock symbol required field in this field you can pass the ticker symbol of publicly traded shares of a particular stock or security on a particular stock exchange; you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: device operating system optional field possible values: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified time window for optional field possible values: default value: Note: if you specify a value that is different from device type optional field return results for a specific device type possible value: ticker or stock symbol required field in this field you can pass the ticker symbol of publicly traded shares of a particular stock or security on a particular stock exchange; you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: device operating system optional field possible values: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified time window for optional field possible values: default value: device type optional field return results for a specific device type possible value: ticker or stock symbol required field in this field you can pass the ticker symbol of publicly traded shares of a particular stock or security on a particular stock exchange; you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: device operating system optional field possible values: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values:: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified time window for optional field possible values: default value: Note: if you specify a value that is different from category of financial instruments to search for optional field possible values: default value: company or financial instrument name required field in this field, you can enter the name of a company or financial instrument to search for relevant tickers; you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified category of financial instruments to search for optional field possible values: default value: company or financial instrument name required field in this field, you can enter the name of a company or financial instrument to search for relevant tickers; you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values:: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified parsing depth optional field number of results in SERP default value: max value: Setting depth above 100 may result in additional charges if the search engine returns more than 100 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically; The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":" keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your if this field contains such parameters as 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', the charge per task will be multiplied by 5 Note: queries containing the ‘cache:’ parameter are not supported and will return a validation error learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field note that this API provides results for desktop only choose from the following values: default value: search engine domain optional field We choose the relevant search engine domain automatically according to the location and language you specify. However, you can set a custom search engine domain in this field example: additional parameters of the search query optional field Get the list of available parameters and additional details here. user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 100 may result in additional charges if the search engine returns more than 100 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically; The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":" keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your if this field contains such parameters as 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', the charge per task will be multiplied by 5 Note: queries containing the ‘cache:’ parameter are not supported and will return a validation error learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field note that this API provides results for desktop only choose from the following values: default value: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 100 may result in additional charges if the search engine returns more than 100 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically; The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":" keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’, the charge per task will be multiplied by 5 Note: queries containing the ‘cache:’ parameter are not supported and will return a validation error learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field note that this API provides results for desktop only choose from the following values: default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":" search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP; default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically; The cost can be calculated on the Pricing page.","type":["integer","null"]},"employment_type":{"description":" employment contract type optional field type of employment contract for which the search results will be returned; possible values: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your Note: the keyword you specify must indicate the job title; example: learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify you can receive the list of available locations of the search engines with their example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: location search radius optional field location search radius in kilometers; Note: for countries that use the imperial system of units, you will need to convert miles to kilometers by multiplying the value in miles by if value is not specified, search is executed anywhere within the specified location; maximal value: minimal value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results respectively; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 9z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 4z the maximum value for \"zoom\": 18z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: device operating system optional field if you specify default value: if you specify default value: task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 9z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 4z the maximum value for \"zoom\": 18z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: filter results by minimum rating optional field possible values for possible values for device operating system optional field if you specify default value: if you specify default value: user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified filter results by open hours optional field using this field, you can filter places in the results by the time a place is open for visitors note that Google may also provide results that do not match this filter possible values: instead of instead of example: parsing depth optional field number of results in SERP default value: max value: If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically device type optional field return results for a specific device type can take the values: default value: keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 9z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 4z the maximum value for \"zoom\": 18z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: device operating system optional field if you specify default value: if you specify default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the function you used for setting a task possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":" user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified parsing depth optional field number of results in SERP default value: max value: Setting depth above 100 may result in additional charges if the search engine returns more than 100 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: note: for keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 17z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 3z the maximum value for \"zoom\": 21z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: search places mode optional field the search places mode allows to obtain Google Maps results on a certain place (e.g., Apple Store in New York) however, due to the pecularities of our data mining algorithm, this mode might interfere with some local-intent queries - and display results for a location that is different from that specified in the request; to prevent this interference and obtain correct results for keywords with local intent you may set this parameter to default value: Note: if the show results from the displayed area optional field can take the values: default value: if set to Note: if the user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 100 may result in additional charges if the search engine returns more than 100 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: note: for keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify if \"zoom\" is not specified, 17z will be applied as a default value the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"zoom\": 3z the maximum value for \"zoom\": 21z example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the function you used for setting a task possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":" search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: search places mode optional field the search places mode allows to obtain Google Maps results on a certain place (e.g., Apple Store in New York) however, due to the pecularities of our data mining algorithm, this mode might interfere with some local-intent queries - and display results for a location that is different from that specified in the request; to prevent this interference and obtain correct results for keywords with local intent you may set this parameter to Note: if the show results from the displayed area optional field can take the values: default value: if set to Note: if the user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set calculate pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: if set to parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":" keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your if this field contains such parameters as 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', the charge per task will be multiplied by 5 Note: queries containing the ‘cache:’ parameter are not supported and will return a validation error learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field note that this API provides results for desktop only choose from the following values: default value: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field Get the list of available parameters and additional details here. direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":" keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your if this field contains such parameters as 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', the charge per task will be multiplied by 5 Note: queries containing the ‘cache:’ parameter are not supported and will return a validation error learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field note that this API provides results for desktop only choose from the following values: default value: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set calculate pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: if set to parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; If the specified depth is higher than the number of results in the response, the difference will be refunded to your account balance automatically; The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":" keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’, the charge per task will be multiplied by 5 Note: queries containing the ‘cache:’ parameter are not supported and will return a validation error learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center device operating system optional field note that this API provides results for desktop only choose from the following values: default value: notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":" search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields; Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method; example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: expand ai overview optional field set to default value: SERP element types to check for targets optional field to enable this parameter, specifies which SERP element types should be checked for target matches if not specified, all first-level elements with possible values: Note: cannot contain the same element types as example: learn more about this parameter on our Help Center SERP element types to exclude from target search optional field to enable this parameter, specifies which SERP element types should be excluded when searching for target matches possible values: Note: cannot contain the same element types as example: learn more about this parameter on our Help Center keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your if this field contains such parameters as 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', the charge per task will be multiplied by 5","type":"string"},"language_code":{"description":" search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: load asynchronous ai overview optional field set to if set to default value: if the element is absent or contains search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl max value: Note: you will be charged for each page crawled (10 organic results per page); learn more about pricing on our Pricing page; Note#2: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified target matching mode optional field to enable this parameter, defines how the crawl should stop when multiple targets are specified in possible values: default value: learn more about this parameter on our Help Center direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: SERP element types to check for targets optional field to enable this parameter, specifies which SERP element types should be checked for target matches if not specified, all first-level elements with possible values: Note: cannot contain the same element types as example: learn more about this parameter on our Help Center display related results optional field if set to if set to default value: SERP element types to exclude from target search optional field to enable this parameter, specifies which SERP element types should be excluded when searching for target matches possible values: Note: cannot contain the same element types as example: learn more about this parameter on our Help Center keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your if you need to use the “+” character for your if this field contains such parameters as 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'site:', the charge per task will be multiplied by 5","type":"string"},"language_code":{"description":" search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl max value: Note: you will be charged for each page crawled (10 organic results per page); learn more about pricing on our Pricing page; Note#2: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified target domain, subdomain, or webpage to get results for optional field a domain or a subdomain should be specified without note that the results of you can also use a wildcard (‘*’) character to specify the search pattern in SERP and narrow down the results; examples: target matching mode optional field to enable this parameter, defines how the crawl should stop when multiple targets are specified in possible values: default value: learn more about this parameter on our Help Center direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; can be specified within the following range: by default, the parameter is set to: Note: to use this parameter, set calcualte pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: provider usage may increase for using this parameter parsing depth optional field number of results in SERP default value: max value: Setting depth above 10 may result in additional charges if the search engine returns more than 10 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":" device type optional field return results for a specific device type can take the values: default value: expand ai overview optional field set to default value: Note: this parameter applies only to HTML task results SERP element types to check for targets optional field to enable this parameter, specifies which SERP element types should be checked for target matches if not specified, all first-level elements with possible values: Note: cannot contain the same element types as example: learn more about this parameter on our Help Center display related results optional field if set to if set to default value: SERP element types to exclude from target search optional field to enable this parameter, specifies which SERP element types should be excluded when searching for target matches possible values: Note: cannot contain the same element types as example: learn more about this parameter on our Help Center keyword required field you can specify up to 700 characters in the all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your if you need to use the “+” character for your if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, the charge per task will be multiplied by 5 learn more about rules and limitations of search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: load asynchronous ai overview optional field set to if set to default value: Note: provider usage may increase for using this parameter; if the element is absent or contains search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: target match type required field if type of match for the possible values: target domain, subdomain, or wildcard value required field if specify a target domain, subdomain, or wildcard value; Note: domain or subdomain must be specified without a request protocol; example: page crawl limit optional field number of search results pages to crawl max value: Note: you will be charged for each page crawled (10 organic results per page); learn more about pricing on our Pricing page; Note#2: the learn more at our help center device operating system optional field if you specify default value: if you specify default value: clicks on the corresponding element optional field specify the click depth on the if the element is absent or we perform fewer clicks than you specified, all extra charges will be returned to your account balance possible values: from notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default); 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"remove_from_url":{"description":" remove specific parameters from URLs optional field using this field, you can specify up to 10 parameters to remove from URLs in the result example: search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified target matching mode optional field to enable this parameter, defines how the crawl should stop when multiple targets are specified in possible values: default value: learn more about this parameter on our Help Center direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method. example: browser screen height optional field you can set a custom browser screen height to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set browser screen resolution ratio optional field you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set browser screen width optional field you can set a custom browser screen width to calculate pixel rankings for a particular device; by default, the parameter is set to Note: to use this parameter, set calculate pixel rankings for SERP elements in advanced results optional field pixel ranking refers to the distance between the result snippet and top left corner of the screen; Visit Help Center to learn more>> by default, the parameter is set to Note: if set to URL of the image required field the results will be based on the image you specified in this field example: search engine language code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their full name of search engine language required field if you don't specify if you use this field, you don't need to specify you can receive the list of available languages of the search engine with their example: search engine location code required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engines with their example: GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199.9 (mm) the maximum value for \"radius\": 199999 (mm) example: full name of search engine location required field if you don't specify if you use this field, you don't need to specify you can receive the list of available locations of the search engine with their example: page crawl limit optional field number of search results pages to crawl max value: Note: the learn more at our help center notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center postback_url datatype required field if you specify corresponds to the datatype that will be sent to your server possible values: URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the you can use the ‘$id’ string as a example: Note: special characters in i.a., the learn more on our Help Center task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":" search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: additional parameters of the search query optional field get the list of available parameters and additional details here user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters results for adult content. The following values are supported: When not set, no filtering is applied — except for local recall, which stays Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results for adult content. The following values are supported: The number of search results returned in response.\nThe maximum is 20. The actual number delivered may be less than requested.\nCombine this parameter with offset to paginate search results. NOTE: Count only applies to web results. Enable rich callback.\nAllows you to get real time rich results via a callback URL when they are relevant to your query. NOTE: Requires Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: The zero based offset that indicates number of search\nresult pages (count) to skip before returning the result.\nThe default is 0 and the maximum is 9.\nThe actual number delivered may be less than requested. Use this parameter along with the count parameter to page results.\nFor example, if your user interface displays 10 search results per page,\nset count to 10 and offset to 0 to get the first page of results.\nFor each subsequent page, increment offset by 1 (for example, 0, 1, 2).\nIt is possible for multiple pages to include some overlap in results. A comma delimited string of result types to include in the search response.\nNot specifying this parameter will return back all result types in search response where data is available\nand the plan has the corresponding option activated. The response always includes query and type to\nidentify any query modifications and response type respectively.\nAvailable result filter values are: NOTE: count param only applies to web results. Filters search results for adult content. The following values are supported: The measurement units. The following values are supported: where possible values: you can get the full list of semantic elements here possible values: possible values: you can get the full list of semantic elements here possible values: possible values: you can get the full list of semantic elements here possible values: possible values: possible values: you can get the full list of semantic elements here possible values: you can get the full list of semantic elements here note that the number of broken pages includes pages on the possible values: you can get the full list of semantic elements here example: example: _ _ _ _ _ _ if there is no data, then the value is_ search volume is rounded to the closest decimal values if there is no data, then the value is_ search volume is rounded to the closest decimal values if there is no data the value is all fields and their descriptions are available in the official documentation by this link.","items":{"additionalProperties":{"type":["object","null"]},"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseTaskGetJsonResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseTaskGetJsonTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseTaskGetJsonTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"items":{"additionalProperties":{"type":["object","null"]},"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"items":{"additionalProperties":{"type":["object","null"]},"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseTasksReadyResultInfo":{"properties":{"endpoint_json":{"description":"URL for collecting the results of the OnPage Lighthouse JSON task","type":["string","null"]},"id":{"description":"task identifier of the completed task possible values: you can get the full list of semantic elements here where `location_code_parent` corresponds to: `\"location_code\": 20044`, where where `location_code_parent` corresponds to: `\"location_code\": 20044`, where `location_code_parent` corresponds to: `\"location_code\": 20044`, note that this array contains all types of search results found in the returned SERP; note that this array contains all types of search results found in the returned SERP; note that this array contains all types of search results found in the returned SERP; to get all items (inlcuding SERP features and rich snippets) found in the returned SERP, please refer to the Naver Organiс Advanced SERP endpoint","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the note that this array contains all types of search results found in the returned SERP; to get all items (inlcuding SERP features and rich snippets) found in the returned SERP, please refer to the Seznam Organiс Advanced SERP endpoint","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the where `location_code_parent` corresponds to: `\"location_code\": 20044`, where `location_code_parent` corresponds to: `\"location_code\": 20044`, Kind tag on a rich suggestion entry. Open set: mixer emits these today, but we may add Rich Header verticals\nover time, so consumers must render an unrecognised value as plain text. These are currencies or cryptocurrencies that the cryptocurrency is\ncompared to. e.g. BTC, ETH, USD, EUR, etc. The number of search results returned in response. The maximum is 200. The actual number delivered may be less than requested. NOTE: Image search is not paginated and has no The number of search results returned in response. The maximum is 200. The actual number delivered may be less than requested. NOTE: Image search is not paginated and has no Filters search results for adult content. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters results for adult content. The following values are supported: When not set, no filtering is applied — except for local recall, which stays Filters results for adult content. The following values are supported: When not set, no filtering is applied — except for local recall, which stays Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters results for adult content. The following values are supported: When not set, no filtering is applied — except for local recall, which stays Location string to search for points of interest in an area.\nThis is alternative to the Location string to search for points of interest in an area.\nThis is alternative to the The measurement units. The following values are supported: The measurement units. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results for adult content. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results for adult content. The following values are supported: The two letter country code for the client’s country.\nFor a list of country codes, see ISO 3166-1 alpha-2. The two letter country code for the client’s country.\nFor a list of country codes, see ISO 3166-1 alpha-2. The number of search results returned in response.\nThe maximum is 20. The actual number delivered may be less than requested.\nCombine this parameter with offset to paginate search results. NOTE: Count only applies to web results. The number of search results returned in response.\nThe maximum is 20. The actual number delivered may be less than requested.\nCombine this parameter with offset to paginate search results. NOTE: Count only applies to web results. Enable rich callback.\nAllows you to get real time rich results via a callback URL when they are relevant to your query. NOTE: Requires Enable rich callback.\nAllows you to get real time rich results via a callback URL when they are relevant to your query. NOTE: Requires Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: The zero based offset that indicates number of search\nresult pages (count) to skip before returning the result.\nThe default is 0 and the maximum is 9.\nThe actual number delivered may be less than requested. Use this parameter along with the count parameter to page results.\nFor example, if your user interface displays 10 search results per page,\nset count to 10 and offset to 0 to get the first page of results.\nFor each subsequent page, increment offset by 1 (for example, 0, 1, 2).\nIt is possible for multiple pages to include some overlap in results. The zero based offset that indicates number of search\nresult pages (count) to skip before returning the result.\nThe default is 0 and the maximum is 9.\nThe actual number delivered may be less than requested. Use this parameter along with the count parameter to page results.\nFor example, if your user interface displays 10 search results per page,\nset count to 10 and offset to 0 to get the first page of results.\nFor each subsequent page, increment offset by 1 (for example, 0, 1, 2).\nIt is possible for multiple pages to include some overlap in results. A comma delimited string of result types to include in the search response.\nNot specifying this parameter will return back all result types in search response where data is available\nand the plan has the corresponding option activated. The response always includes query and type to\nidentify any query modifications and response type respectively.\nAvailable result filter values are: NOTE: count param only applies to web results. A comma delimited string of result types to include in the search response.\nNot specifying this parameter will return back all result types in search response where data is available\nand the plan has the corresponding option activated. The response always includes query and type to\nidentify any query modifications and response type respectively.\nAvailable result filter values are: NOTE: count param only applies to web results. Filters search results for adult content. The following values are supported: Filters search results for adult content. The following values are supported: The measurement units. The following values are supported: The measurement units. The following values are supported: The two letter country code for the client’s country.\nFor a list of country codes, see ISO 3166-1 alpha-2. The two letter country code for the client’s country.\nFor a list of country codes, see ISO 3166-1 alpha-2. The number of search results returned in response.\nThe maximum is 20. The actual number delivered may be less than requested.\nCombine this parameter with offset to paginate search results. NOTE: Count only applies to web results. Enable rich callback.\nAllows you to get real time rich results via a callback URL when they are relevant to your query. NOTE: Requires Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported: The zero based offset that indicates number of search\nresult pages (count) to skip before returning the result.\nThe default is 0 and the maximum is 9.\nThe actual number delivered may be less than requested. Use this parameter along with the count parameter to page results.\nFor example, if your user interface displays 10 search results per page,\nset count to 10 and offset to 0 to get the first page of results.\nFor each subsequent page, increment offset by 1 (for example, 0, 1, 2).\nIt is possible for multiple pages to include some overlap in results. A comma delimited string of result types to include in the search response.\nNot specifying this parameter will return back all result types in search response where data is available\nand the plan has the corresponding option activated. The response always includes query and type to\nidentify any query modifications and response type respectively.\nAvailable result filter values are: NOTE: count param only applies to web results. Filters search results for adult content. The following values are supported: The measurement units. The following values are supported: learn more about rules and limitations of Note: learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"system_message":{"description":"instructions for the AI behaviour Note: learn more about rules and limitations of learn more about rules and limitations of learn more about rules and limitations of learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority Note: Note: learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"system_message":{"description":"instructions for the AI behaviour Note: Note: learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results learn more on our Help Center","type":["string","null"]},"system_message":{"description":"instructions for the AI behavior learn more about rules and limitations of GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199 (mm) the maximum value for \"radius\": 199999 (mm) example: learn more about rules and limitations of GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199 (mm) the maximum value for \"radius\": 199999 (mm) example: learn more about rules and limitations of GPS coordinates of a location required field if you don't specify if you use this field, you don't need to specify the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 199 (mm) the maximum value for \"radius\": 199999 (mm) example: learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"language_code":{"description":"search language code default value: default value: you can add several filters at once (8 filters maximum) the full list of possible filters is available here. you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_brand_categories":{"description":"array of brand_categories to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_brand_categories":{"description":"array of brand categories to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_brands":{"description":"array of brands to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_brands":{"description":"array of brands to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_domains":{"description":"array of domains to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_domains":{"description":"array of domains to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_pages":{"description":"array of pages to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here. default value: The full list of possible filters is available here.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"include_pages":{"description":"array of page URLs to include in the response you can add several filters at once (8 filters maximum) the full list of possible filters is available here.
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},{"properties":{"domain":{"description":"target domain\nrequired field if you don’t specify keyword\na domain should be specified without https:// and www.","type":["string","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target domain will be included in the search\noptional field\nif set to true, the subdomains will be included in the search\ndefault value: false","type":["boolean","null"]}},"type":"object"}]},"Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},{"properties":{"keyword":{"description":"target keyword\nrequired field if you don’t specify domain\nyou can specify up to 2000 characters in the keyword field\nall %## will be decoded (plus character ‘+’ will be decoded to a space character)\nif you need to use the “%” character for your keyword, please specify it as “%25”;\nif you need to use the “+” character for your keyword, please specify it as “%2B”\nlearn more about rules and limitations of keyword and keywords fields in","type":["string","null"]},"match_type":{"description":"target keyword match type\ndefines how the specified keyword is matched\noptional field\npossible values:\nword_match – full-text search for terms that match the specified seed keyword with additional words included before, after, or within the key phrase (e.g., search for “light” will return results with “light bulb”, “light switch”);\npartial_match – substring search that finds all instances containing the specified sequence of characters, even if it appears inside a longer word (e.g., search for “light” will return results with “lighting”, “highlight”);\ndefault value: word_match","type":["string","null"]}},"type":"object"}]},"Provider0A3E90081762_AiOptimizationLLmMentionsMultiTargetMetricsRequestInfo":{"properties":{"key":{"description":"key for grouping the results\nrequired field\ngroups results for comparison and serves as a label for the group;\nyou can specify up to 250 characters in the key field","type":["string","null"]},"target":{"items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveRequestInfo":{"properties":{"date_from":{"description":"start date of the time range
optional field
minimal value 2025-08-01
date format \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"end date of the time range
optional field
Note value specified in date_from cannot exceed the value in date_to
date format \"yyyy-mm-dd\"","type":["string","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domainsearch_results_domain
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"the maximum number of returned objects
optional field100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000, use the search_after_token if you would like to offset more results","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsMultiTargetMetricsRequestInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"the maximum number of returned objects
optional field100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000, use the search_after_token if you would like to offset more results","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"search_after_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 1000 results in a single request;
by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;
Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveRequestInfo":{"properties":{"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveRequestInfo":{"properties":{"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domainsearch_results_domain
minimum value: 1
maximum value: 10
default value: 10","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveRequestInfo":{"properties":{"date_from":{"description":"start date of the time range
required field
minimal value: 2025-08-01
date format: \"yyyy-mm-dd\"","type":"string"},"date_to":{"description":"end date of the time range
required field
Note:the value specified in date_from cannot exceed the value in date_to
date format: \"yyyy-mm-dd\"","type":"string"},"group_range":{"description":"timeseries delta range
required field
possible values:day, week, month, year","type":"string"},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveRequestInfo":{"properties":{"date_from":{"description":"start date of the time range
required field
minimal value: 2025-08-01
date format: \"yyyy-mm-dd\"","type":"string"},"date_to":{"description":"end date of the time range
required field
Note:the value specified in date_from cannot exceed the value in date_to
date format: \"yyyy-mm-dd\"","type":"string"},"group_range":{"description":"timeseries range
required field
possible values:day, week, month, year","type":"string"},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveRequestInfo":{"properties":{"exclude_brand_categories":{"description":"array of brand categories to exclude from the response
optional field
if specified, the listed brand categories will be omitted from the items array
example:[\"company\",\"insurance\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed brand categories will be returned in the items array
example:[\"company\",\"insurance\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveRequestInfo":{"properties":{"exclude_brand_categories":{"description":"array of brand categories to exclude from the response
optional field
if specified, the listed brand categories will be omitted from the items array
example:\"exclude_brand_categories\": [\"business\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed brand categories will be returned in the items array
example:\"include_brand_categories\": [\"business\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveRequestInfo":{"properties":{"exclude_brands":{"description":"array of brands to exclude from the response
optional field
if specified, the listed brands will be omitted from the items array
example:[\"BMW\",\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\", 1000]
optional field
if specified, only the listed brands will be returned in the items array
example:[\"BMW\",\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveRequestInfo":{"properties":{"exclude_brands":{"description":"array of brands to exclude from the response
optional field
if specified, the listed brands will be omitted from the items array
example:\"exclude_brands\": [\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed brands will be returned in the items array
example:\"include_brands\": [\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveRequestInfo":{"properties":{"exclude_domains":{"description":"array of domains to exclude from the response
optional field
if specified, the listed domains will be omitted from the items array
example:[\"google.com\",\"bing.com\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed domains will be returned in the items array
example:[\"dataforseo.com\",\"seoinsider.com\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en onlyn","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources;
Note: if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveRequestInfo":{"properties":{"exclude_domains":{"description":"array of domains to exclude from the response
optional field
if specified, the listed domains will be omitted from the items array
example:\"exclude_domains\": [\"en.wikipedia.org\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed domains will be returned in the items array
example:\"include_domains\": [\"en.wikipedia.org\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources
Note:if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveRequestInfo":{"properties":{"exclude_pages":{"description":"array of page URLs to exclude from the response
optional field
if specified, the listed pages will be omitted from the items array
example:
`[\"https://dataforseo.com/apis/ai-optimization-api/llm-mentions-api\", \"https://dataforseo.com/apis/ai-optimization-api\"]`","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed pages will be returned in the items array
example:
`[\"https://dataforseo.com/apis/ai-optimization-api/llm-mentions-api\", \"https://dataforseo.com/apis/ai-optimization-api\"]`","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources; ;
Note: if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveRequestInfo":{"properties":{"exclude_pages":{"description":"array of pages to exclude from the response
optional field
if specified, the listed pages will be omitted from the items array
example:\"exclude_pages\": [\"https://example.page/\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed pages will be returned in the items array
example:\"include_pages\": [\"https://example.page/\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources;
Note:if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_AiOptimizationPerplexityLlmResponsesLiveRequestInfo":{"properties":{"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1
maximum value: 4096;
default value: 2048;
Note: if the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_LlmMessageChainItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
you can receive the list of available LLM models by making a separate request to the following endpoint: https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behavior
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse
lower values make output more focused
minimum value: 0
maximum value: 1.9
default value: 0.77","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection
minimum value: 0
maximum value: 1
default value: 0.9","type":["number","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search_country_iso_code":{"description":"country code for web search localization
optional field
specify the country ISO code to get localized web search results
Note: available only for Perplexity Sonar models
example: US","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AisaDataforseoFilterJsonValue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"Provider0A3E90081762_AppDataAppleAppInfoTaskPostRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on App Store;
you can find the ID in the URL of every app listed on App Store;
example:
in the URL `https://apps.apple.com/us/app/id835599320`
the id is `835599320`","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to `https://api.dataforseo.com/v3/app_data/apple/languages`
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to `https://api.dataforseo.com/v3/app_data/apple/languages`
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to `https://api.dataforseo.com/v3/app_data/apple/locations`
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to `https://api.dataforseo.com/v3/app_data/apple/locations`
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:
`http://your-server.com/pingscript?id=$id`
`http://your-server.com/pingscript?id=$id&tag=$tag`
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:
`http://your-server.com/postbackscript?id=$id`
`http://your-server.com/postbackscript?id=$id&tag=$tag`
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priority You will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataAppleAppListTaskPostRequestInfo":{"properties":{"app_category":{"description":"application category on the App Storeoptional fieldyou can filter the results by app category;example:lifestyle;you can review the full list of available categories here or by making a separate request to https://api.dataforseo.com/v3/app_data/apple/categories","type":["string","null"]},"app_collection":{"description":"app collectionrequired fieldapp collection on App Store from which apps will be collected;you can specify the following values:top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios","type":"string"},"depth":{"description":"parsing depthoptional fieldnumber of apps to be returned from the App Store SERP;default value: 100maximum value: 100Your account will be billed per each SERP containing up to 100 results; The cost can be calculated on the Pricing page.","type":["integer","null"]},"language_code":{"description":"\"search engine language coderequired field if you don't specify language_nameif you use this field, you don't need to specify language_nameyou can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/app_data/apple/languagesexample:en","type":["string","null"]},"language_name":{"description":"full name of search engine languagerequired field if you don't specify language_codeif you use this field, you don't need to specify language_codeyou can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/apple/languagesexample:English","type":["string","null"]},"location_code":{"description":"search engine location coderequired field if you don't specify location_nameif you use this field, you don't need to specify location_nameyou can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/apple/locationsexample:9061121","type":["integer","null"]},"location_name":{"description":"full name of search engine locationrequired field if you don't specify location_codeif you use this field, you don't need to specify location_codeyou can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/apple/locationsexample:West Los Angeles,California,United States","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed taskoptional fieldwhen a task is completed we will notify you by GET request sent to the URL you have specifiedyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagNote: special characters in pingback_url will be urlencoded; i.a., the # character will be encoded into %23learn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatyperequired field if you specify postback_urlcorresponds to the datatype that will be sent to your serverpossible values:advanced","type":["string","null"]},"postback_url":{"description":"URL for sending task resultsoptional fieldonce the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specifiedyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagNote: special characters in postback_url will be urlencoded; i.a., the # character will be encoded into %23learn more on our Help Center","type":["string","null"]},"priority":{"description":"task priorityoptional fieldcan take the following values:1 – normal execution priority (set by default)2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataAppleAppListingsSearchLiveRequestInfo":{"properties":{"categories":{"description":"app categories
optional field
the categories you specify are used to search for app listings;
you can get the full list of available app listing categories by this link
you can specify up to 10 categories","items":{"type":"string"},"type":["array","null"]},"description":{"description":"keyword in the app's description
optional field
keywords that occur in the description of the app;
can contain up to 200 characters","type":["string","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"rating.value\",\">\",3]https://api.dataforseo.com/v3/app_data/apple/app_listings/available_filtersn","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"limit":{"description":"the maximum number of returned apps
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned apps
optional field
default value: 0
if you specify the 10 value, the first ten entities in the results array will be omitted and the data will be provided for the successive entities
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:[\"item.rating.value,desc\"]
you should use a comma to separate several sorting rules
example:[\"item.rating.value,desc\",\"item.rating.value,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"title":{"description":"keyword in the app's title
optional field
keywords that occur in the title of the app;
can contain up to 200 characters","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataAppleAppReviewsTaskPostRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on App Store;
you can find the ID in the URL of every app listed on App Store;
example:
in the URL https://apps.apple.com/us/app/id835599320
the id is 835599320","type":"string"},"depth":{"description":"parsing depth
optional field
number of reviews to be returned in the API response;
we strongly recommend setting the parsing depth in the multiples of 25, because our system processes 25 reviews in a row;
default value: 25;
maximum value: 500;
Setting depth above 25 may result in additional charges if the search engine returns more than 25 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/app_data/apple/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/apple/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/apple/locations
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/apple/locations
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"sort_by":{"description":"results sorting parameters
optional field
you can use this field to sort the results;
possible types of sorting:most_recent — sort by the most recent reviews;most_helpful — sort by the most relevant reviews;
default rule: most_helpful","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataAppleAppSearchesTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results to be returned from the App Store SERP;
we strongly recommend setting the parsing depth in the multiples of 100, because our system processes 100 results in a row;
default value: 100
maximum value: 700
Your account will be billed per each SERP containing up to 100 results;
Setting depth above 100 may result in additional charges if the search engine returns more than 100 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if language_name is not specified
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/app_data/apple/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if language_code is not specified
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/apple/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/apple/locations
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/apple/locations
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataGoogleAppInfoTaskPostRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on Google Play;
you can find the ID in the URL of every app listed on Google Play;
example:
in the URL https://play.google.com/store/apps/details?id=org.telegram.messenger
the id is org.telegram.messenger","type":"string"},"language_code":{"description":"search engine language code
required field if language_name is not specified
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if language_code is not specified
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"postback_data":{"description":"postback_url datatype
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataGoogleAppListTaskPostRequestInfo":{"properties":{"age_rating":{"description":"filter results by age rating
optional field
you can use this field to filter the results by age rating;
possible types of filtering:ages_up_to_5 — return apps approved for children up to 5 years old;ages_6_8 — return apps approved for children from 6 to 8 years old;ages_9_12 — return apps approved for children from 9 to 12 years old;
by default, the API returns apps for all ages;
Note: this filter works only in conjunction with the \"category\": \"family\" parameter","type":["string","null"]},"app_category":{"description":"application category on Google Play
optional field
you can filter the results by app category;
example:family;
you can receive the full list of available categories by making a separate request to https://api.dataforseo.com/v3/app_data/google/categories
Note: app_category cannot be used if app_collection parameter is set to featured","type":["string","null"]},"app_collection":{"description":"app collection
required field
app collection on Google Play from which apps will be collected;
you can specify the following values:featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing, movers_shakers
Note: if featured is selected, the app_category parameter cannot be used","type":"string"},"depth":{"description":"parsing depth
optional field
number of apps to be returned in the API response;
we strongly recommend setting the parsing depth in the multiples of 100, because our system processes 100 results in a row;
default value: 100;
maximum value: 200;
Your account will be billed per each SERP containing up to 100 results;
Setting depth above 100 may result in additional charges if the search engine returns more than 100 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"language_code":{"description":"search engine language code
required field if language_name is not specified
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if language_code is not specified
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"postback_data":{"description":"postback_url datatype
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataGoogleAppListingsSearchLiveRequestInfo":{"properties":{"categories":{"description":"app categories
optional field
the categories you specify are used to search for app listings;
you can get the full list of available app listing categories by this link
you can specify up to 10 categories","items":{"type":"string"},"type":["array","null"]},"description":{"description":"keyword in the app's description
optional field
keywords that occur in the description of the app;
can contain up to 200 characters","type":["string","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"item.rating.value\",\">\",3]https://api.dataforseo.com/v3/app_data/google/app_listings/available_filters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"limit":{"description":"the maximum number of returned apps
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned apps
optional field
default value: 0
if you specify the 10 value, the first ten entities in the results array will be omitted and the data will be provided for the successive entities
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:[\"item.installs_count,asc\"]
you should use a comma to separate several sorting rules
example:[\"item.rating.value,desc\",\"item.installs_count,asc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"title":{"description":"keyword in the app's title
optional field
keywords that occur in the title of the app;
can contain up to 200 characters","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataGoogleAppReviewsTaskPostRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on Google Play;
you can find the ID in the URL of every app listed on Google Play;
example:https://play.google.com/store/apps/details?id=org.telegram.messenger","type":"string"},"depth":{"description":"parsing depth
optional field
number of reviews to be returned in the API response;
we strongly recommend setting the parsing depth in the multiples of 150, because our system processes 150 reviews in a row;
default value: 150;
maximum value: 100000;
Your account will be billed per each SERP containing up to 150 results;
Setting depth above 150 may result in additional charges if the search engine returns more than 150 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"postback_data":{"description":"postback_url datatype
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"rating":{"description":"filter reviews by rating
optional field
you can use this field to filter the results;
possible types of filtering:5 — return reviews with five-star rating only;4 — return reviews with four-star rating only;3 — return reviews with three-star rating only;2 — return reviews with two-star rating only;1 — return reviews with one-star rating only;
by default, the API returns all reviews regardless of the number of stars","type":["integer","null"]},"sort_by":{"description":"results sorting parameters
optional field
you can use this field to sort the results;
possible types of sorting:newest — sort by the most recent reviews;most_relevant — sort by the most relevant reviews;
default rule: most_relevant","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_AppDataGoogleAppSearchesTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results to be returned to be returned from the Google Play SERP;
we strongly recommend setting the parsing depth in the multiples of 30, because our system processes 30 results in a row;
default value: 30;
maximum value: 200;
Your account will be billed per each SERP containing up to 30 results;
Setting depth above 30 may result in additional charges if the search engine returns more than 30 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:9061121","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/app_data/google/locations
example:West Los Angeles,California,United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"postback_data":{"description":"postback_url datatype
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23","type":["string","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BacklinksAnchorsLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [[\"dofollow\", \"=\", true]]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates whether the backlinks from subdomains of the target are excluded
optional field
if set to false, the backlinks from subdomains of the target will be ommited and you won't receive the same domain in the response;
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"referring_links_types.anchors\",\">\",\"1\"][[\"broken_pages\",\">\",\"2\"],
\"and\",
[\"backlinks\",\">\",\"10\"]][[\"first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"anchor\",\"like\",\"%seo%\"],\"or\",[\"referring_domains\",\">\",\"10\"]]]target will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to the target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"limit":{"description":"the maximum number of returned anchors
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned anchors
optional field
default value: 0
if you specify the 10 value, the first ten anchors in the results array will be omitted and the data will be provided for the successive anchors","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"backlinks,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"backlinks,desc\",\"rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get anchors for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksBacklinksLiveRequestInfo":{"properties":{"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"custom_mode":{"additionalProperties":{"type":["object","null"]},"description":"detailed results grouping type
optional field
use this object to get a specific number of backlinks per field
if you use custom_mode, then mode will be ignored
example:\"custom_mode\": {\"field\": \"domain\", \"value\": 100}","type":["object","null"]},"exclude_internal_backlinks":{"description":"indicates if internal backlinks from subdomains to the target will be excluded from the results
optional field
if set to true, the results will not include data on internal backlinks from subdomains of the same domain as target
if set to false, internal links will be included in the results
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"rank\",\">\",\"80\"][[\"page_from_rank\",\">\",\"55\"],
\"and\",
[\"dofollow\",\"=\",true]][[\"first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"anchor\",\"like\",\"%seo%\"],\"or\",[\"text_pre\",\"like\",\"%seo%\"]]]target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"limit":{"description":"the maximum number of returned backlinks
optional field100
maximum value: 1000","type":["integer","null"]},"mode":{"description":"results grouping type
optional field
possible grouping types:as_is - returns all backlinksone_per_domain - returns one backlink per domainone_per_anchor - returns one backlink per anchoras_is","type":["string","null"]},"offset":{"description":"offset in the results array of the returned backlinks
optional field0
if you specify the 10 value, the first ten backlinks in the results array will be omitted and the data will be provided for the successive backlinks;
Note: the maximum value is 20,000, use the search_after_token if you would like to offset more results","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"rank,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"domain_from_rank,desc\",\"page_from_rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 20,000 results in a single request;
by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;
Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get backlinks for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkBacklinksLiveRequestInfo":{"properties":{"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get the number of backlinks for
required field
you can set up to 1000 domains, subdomains or webpages
the domain or subdomain should be specified without https:// and www.
the page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkNewLostBacklinksLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
this field indicates the date which will be used as a threshold for new and lost backlinks;
the backlinks that appeared in our index after the specified date will be considered as new;
the backlinks that weren't found after the specified date, but were present before, will be considered as lost;
e.g. if today is 2021-10-13, default date_from will be 2021-09-13.
minimum value equals today's date -(minus) one year;
e.g. if today is 2021-10-13, minimum date_from will be 2020-10-13.\"yyyy-mm-dd\"
example:\"2021-01-01\"","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get new & lost backlinks for
required field
you can set up to 1000 domains, subdomains or webpages
the domain or subdomain should be specified without `https://` and `www.` the page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
this field indicates the date which will be used as a threshold for new and lost referring domains;
the referring domains that appeared in our index after the specified date will be considered as new;
the referring domains that weren't found after the specified date, but were present before, will be considered as lost;
e.g. if today is 2021-10-13, default date_from will be 2021-09-13.
minimum value equals today's date -(minus) one year;
e.g. if today is 2021-10-13, minimum date_from will be 2020-10-13.\"yyyy-mm-dd\"
example:\"2021-01-01\"","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get new & lost referring domains for
required field
you can set up to 1000 domains, subdomains or webpages
the domain or subdomain should be specified without https:// and www.
the page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkPagesSummaryLiveRequestInfo":{"properties":{"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get summary data for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)
you can specify up to 1000 pages, domains, or subdomains in each request.
note that the URLs you set in a single request cannot belong to more than 100 different domains.","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkRanksLiveRequestInfo":{"properties":{"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get rank for
required field
you can set up to 1000 domains, subdomains or webpages
the domain or subdomain should be specified without https:// and www.
the page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkReferringDomainsLiveRequestInfo":{"properties":{"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get the number of referring domains for
required field
you can set up to 1000 domains, subdomains or webpages
the domain or subdomain should be specified without https:// and www.
the page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksBulkSpamScoreLiveRequestInfo":{"properties":{"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"domains, subdomains or webpages to get rank for
required field
you can set up to 1000 domains, subdomains or webpages
the domain or subdomain should be specified without https:// and www.
the page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": [
\"forbes.com\",
\"cnn.com\",
\"bbc.com\",
\"yelp.com\",
\"https://www.apple.com/iphone/\",
\"https://ahrefs.com/blog/\",
\"ibm.com\",
\"https://variety.com/\",
\"https://stackoverflow.com/\",
\"www.trustpilot.com\"
]`","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_BacklinksCompetitorsLiveRequestInfo":{"properties":{"exclude_internal_backlinks":{"description":"indicates if internal backlinks from subdomains to the target will be excluded from the results
optional field
if set to true, the results will not include data on internal backlinks from subdomains of the same domain as target
if set to false, internal links will be included in the results
default value: true","type":["boolean","null"]},"exclude_large_domains":{"description":"indicates whether large domain will appear in results
optional field
if set to true, the results from the large domain (google.com, amazon.com, etc.) will be omitted;
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"rank\",\">\",\"100\"][[\"target\",\"like\",\"%forbes%\"],
\"and\",
[[\"rank\",\">\",\"100\"],\"or\",[\"intersections\",\">\",\"5\"]]]
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"main_domain":{"description":"indicates if only main domain of the target will be included in the search
optional field
if set to true, only the main domain will be included in search;
default value: true","type":["boolean","null"]},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"rank,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"intersections,desc\",\"rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get competitor domains for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksDomainIntersectionLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [[\"dofollow\", \"=\", true]]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your targets;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates whether the backlinks from subdomains of the target are excluded
optional field
if set to false, the backlinks from subdomains of the target will be omitted and you won't receive the same domain in the response;
default value: true","type":["boolean","null"]},"exclude_targets":{"description":"domains, subdomains or webpages you want to exclude
optional field
you can specify up to 10 domains, subdomains or webpages
if you use this array, results will contain the referring domains that link to targets but don't link to exclude_targets
example:
`\"exclude_targets\": [
\"bbc.com\",
\"https://www.apple.com/iphone/*\",
\"https://dataforseo.com/apis/*\"]`","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"1.internal_links_count\",\">\",\"1\"][[\"2.referring_pages\",\">\",\"2\"],
\"and\",
[\"1.backlinks\",\">\",\"10\"]][[\"1.first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"2.target\",\"like\",\"%dataforseo.com%\"],\"or\",[\"1.referring_domains\",\">\",\"10\"]]]targets will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to a target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"intersection_mode":{"description":"indicates whether to intersect backlinks
optional field
use this field to intersect or merge results for the specified domains
possible values: all, partialall - results are based on all backlinks;partial - results are based on the intersecting backlinks only;
default value: all","type":["string","null"]},"limit":{"description":"the maximum number of returned results
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the array of returned results
optional field
default value: 0
if you specify the 10 value, the first ten backlinks in the results array will be omitted and the data will be provided for the successive backlinks","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"backlinks,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"backlinks,desc\",\"rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"additionalProperties":{"type":["string","null"]},"description":"domains, subdomains or webpages to get links for
required field
you can set up to 20 domains, subdomains or webpages
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": {
\"1\": \"http://planet.postgresql.org/\",
\"2\": \"http://gborg.postgresql.org/\"
}`","type":["object","null"]}},"type":"object"},"Provider0A3E90081762_BacklinksDomainPagesLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [\"dofollow\", \"=\", true]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates if internal backlinks from subdomains to the target will be excluded from the results
optional field
if set to true, the results will not include data on internal backlinks from subdomains of the same domain as target
if set to false, internal links will be included in the results
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"meta.internal_links_count\",\">\",\"1\"][[\"meta.external_links_count\",\">\",\"2\"],
\"and\",
[\"backlinks\",\">\",\"10\"]][[\"first_visited\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"title\",\"like\",\"%seo%\"],\"or\",[\"referring_domains\",\">\",\"10\"]]]target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"limit":{"description":"the maximum number of returned pages
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned pages
optional field
default value: 0
if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"page_summary.backlinks,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"page_summary.backlinks,desc\",\"page_summary.rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain or subdomain
required field
a domain or a subdomain should be specified without https:// and www.
example:forbes.com","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksDomainPagesSummaryLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [[\"dofollow\", \"=\", true]]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates whether the backlinks from subdomains of the target are excluded
optional field
if set to false, backlinks from the subdomains of the target domain will be ommited and you won't receive the same domain in the response;
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"referring_links_types.anchors\",\">\",\"1\"][[\"broken_pages\",\">\",\"2\"],
\"and\",
[\"backlinks\",\">\",\"10\"]][[\"first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"anchor\",\"like\",\"%seo%\"],\"or\",[\"referring_domains\",\">\",\"10\"]]]target will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to the target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target domain will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"limit":{"description":"the maximum number of returned anchors
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned anchors
optional field
default value: 0
if you specify the 10 value, the first ten anchors in the results array will be omitted and the data will be provided for the successive anchors","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"backlinks,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"backlinks,desc\",\"rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get summary data for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksHistoryLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimum value 2019-01-01
if you don't specify this field, the minimum value will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain
required field
a domain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksPageIntersectionLiveRequestInfo":{"properties":{"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your targets;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates if internal backlinks from subdomains to the target will be excluded from the results
optional field
if set to true, the results will not include data on internal backlinks from subdomains of the same domain as target
if set to false, internal links will be included in the result
default value: true","type":["boolean","null"]},"exclude_targets":{"description":"domains, subdomains or webpages you want to exclude
optional field
you can set up to 10 domains, subdomains or webpages
if you use this array, results will contain the referring pages that link to targets but don't link to exclude_targets
example:
`\"exclude_targets\": [
\"bbc.com\",
\"https://www.apple.com/iphone/*\",
\"https://dataforseo.com/apis/*\"]`","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"1.rank\",\">\",\"80\"][[\"2.page_from_rank\",\">\",\"55\"],
\"and\",
[\"1.original\",\"=\",\"true\"]][[\"1.first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"1.acnhor\",\"like\",\"%seo%\"],\"or\",[\"1.text_pre\",\"not_like\",\"%seo%\"]]]targets will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to a target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the targets will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:attributesdomain_from_platform_type10
maximum value: 1000","type":["integer","null"]},"intersection_mode":{"description":"indicates whether to intersect backlinks
optional field
use this field to intersect or merge results for the specified URLs
possible values: all, partialall - results are based on all backlinks;partial - results are based on the intersecting backlinks only;
default value: all","type":["string","null"]},"limit":{"description":"the maximum number of returned backlinks
optional field100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of the returned backlinks
optional field0
if you specify the 10 value, the first ten backlinks in the results array will be omitted and the data will be provided for the successive backlinks","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"rank,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"domain_from_rank,desc\",\"page_from_rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"additionalProperties":{"type":["string","null"]},"description":"domains, subdomains or webpages to get links for
required field
you can set up to 20 domains, subdomains or webpages
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)
example:
`\"targets\": {
\"1\": \"http://planet.postgresql.org/\",
\"2\": \"http://gborg.postgresql.org/\"
}`","type":["object","null"]}},"type":"object"},"Provider0A3E90081762_BacklinksReferringDomainsLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [\"dofollow\", \"=\", true]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates whether the backlinks from subdomains of the target are excluded
optional field
if set to false, the backlinks from subdomains of the target will be ommited and you won't receive the same domain in the response;
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"referring_pages\",\">\",\"1\"][[\"referring_pages\",\">\",\"2\"],
\"and\",
[\"backlinks\",\">\",\"10\"]][[\"first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"domain\",\"like\",\"%dataforseo.com%\"],\"or\",[\"referring_domains\",\">\",\"10\"]]]target will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to the target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"limit":{"description":"the maximum number of returned domains
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"backlinks,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"backlinks,desc\",\"rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get referring domains for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksReferringNetworksLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [[\"dofollow\", \"=\", true]]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates whether the backlinks from subdomains of the target are excluded
optional field
if set to false, the backlinks from subdomains of the target will be ommited and you won't receive the same domain in the response;
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"referring_pages\",\">\",\"1\"][[\"referring_pages\",\">\",\"2\"],
\"and\",
[\"backlinks\",\">\",\"10\"]][[\"first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],
\"and\",
[[\"network_address\",\"like\",\"194.1.%\"],\"or\",[\"referring_ips\",\">\",\"10\"]]]target will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to the target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"limit":{"description":"the maximum number of returned networks
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"network_address_type":{"description":"indicates the type of network to get data for
optional field
possible values: ip, subnet
default value: ip","type":["string","null"]},"offset":{"description":"offset in the results array of returned networks
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"backlinks,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"backlinks,desc\",\"rank,asc\"]","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get referring networks for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksSummaryLiveRequestInfo":{"properties":{"backlinks_filters":{"description":"filter the backlinks of your target
optional field
you can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target
you can filter the backlinks by all fields available in the response of this endpoint
using this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics for
example:\"backlinks_filters\": [\"dofollow\", \"=\", true]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"backlinks_status_type":{"description":"set what backlinks to return and count
optional field
you can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;
possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;live","type":["string","null"]},"exclude_internal_backlinks":{"description":"indicates if internal backlinks from subdomains to the target will be excluded from the results
optional field
if set to true, the results will not include data on internal backlinks from subdomains of the same domain as target
if set to false, internal links will be included in the results
default value: true","type":["boolean","null"]},"include_indirect_links":{"description":"indicates if indirect links to the target will be included in the results
optional field
if set to true, the results will include data on indirect links pointing to a page that either redirects to the target, or points to a canonical page
if set to false, indirect links will be ignored
default value: true","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations10
maximum value: 1000","type":["integer","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain, subdomain or webpage to get data for
required field
a domain or a subdomain should be specified without https:// and www.
a page should be specified with absolute URL (including http:// or https://)","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
this field indicates the date which will be used as a threshold for new and lost backlinks and referring domains;
the backlinks and referring domains that appeared in our index after the specified date will be considered as new;
the backlinks and referring domains that weren't found after the specified date, but were present before, will be considered as lost;2019-01-30
maximum value shouldn't exceed the date specified in the date_to
date format: \"yyyy-mm-dd\"
example:\"2021-01-01\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
minimum value shouldn't preceed the date specified in the date_from
maximum value: today's date
date format: \"yyyy-mm-dd\"
example:\"2021-01-15\"","type":["string","null"]},"group_range":{"description":"time range which will be used to group the results
optional field
default value: month
possible values: day, week, month, yearday, we will return items corresponding to all dates between and including date_from and date_to;
for week/month/year, we will return items corresponding to full weeks/months/years, where each item will indicate the last day of the week/month/year\"group_range\": \"month\",
\"date_from\": \"2022-03-23\",
\"date_to\": \"2022-05-13\"
we will return items falling between 2022-03-01 and 2022-05-31, namely, three items corresponding to the following dates: 2022-03-31, 2022-04-30, 2022-05-31day/week/month/year, we will return 0","type":["string","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain to get data for
required field
a domain should be specified without https:// and www.
example:\"forbes.com\"","type":"string"}},"type":"object"},"Provider0A3E90081762_BacklinksTimeseriesSummaryLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
this field indicates the date which will be used as a threshold for summary data;2019-01-30
maximum value shouldn't exceed the date specified in the date_to
date format: \"yyyy-mm-dd\"
example:\"2021-01-01\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
minimum value shouldn't preceed the date specified in the date_from
maximum value: today's date
date format: \"yyyy-mm-dd\"
example:\"2021-01-15\"","type":["string","null"]},"group_range":{"description":"time range which will be used to group the results
optional field
default value: month
possible values: day, week, month, yearday, we will return items corresponding to all dates between and including date_from and date_to;
for week/month/year, we will return items corresponding to full weeks/months/years, where each item will indicate the last day of the week/month/year\"group_range\": \"month\",
\"date_from\": \"2022-03-23\",
\"date_to\": \"2022-05-13\"
we will return items falling between 2022-03-01 and 2022-05-31, namely, three items corresponding to the following dates: 2022-03-31, 2022-04-30, 2022-05-31day/week/month/year, we will return 0","type":["string","null"]},"include_subdomains":{"description":"indicates if the subdomains of the target will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain to get data for
required field
a domain should be specified without https:// and www.
example:\"forbes.com\"","type":"string"}},"type":"object"},"Provider0A3E90081762_BaseAiOptimizationLLmMentionsTargetElement":{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataBusinessListingsSearchLiveRequestInfo":{"properties":{"categories":{"description":"business categories
optional field
the categories you specify are used to search for business listings;
if you don't use this field, we will return business listings found in the specified location;
you can specify up to 10 categories","items":{"type":"string"},"type":["array","null"]},"description":{"description":"description of the element in SERP
optional field
the description of the business entity for which the results are collected;
can contain up to 200 characters","type":["string","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"rating.value\",\">\",3]
you can receive the list of available filters_by making a separate request to https://api.dataforseo.com/v3/business_data/business_listings/available_filters
The full list of possible filters is available here.n","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"is_claimed":{"description":"indicates whether the business is verified by its owner on Google Maps
optional field","type":["boolean","null"]},"limit":{"description":"the maximum number of returned businesses
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional fieldlocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the value of \"radius\" is specified in kilometres (km)
the minimum value for \"radius\": 1
the maximum value for \"radius\": 100000
example:53.476225,-2.243572,200
learn more about how to set location parameters in this API on our Help Center","type":["string","null"]},"offset":{"description":"offset in the results array of returned businesses
optional field
default value: 0
if you specify the 10 value, the first ten entities in the results array will be omitted and the data will be provided for the successive entities
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:[\"rating.value,desc\"]note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"rating.value,desc\",\"rating.votes_count,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"title":{"description":"title of the element in SERP
optional field
the name of the business entity for which the results are collected;
can contain up to 200 characters","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleExtendedReviewsTaskPostRequestInfo":{"properties":{"cid":{"description":"unique, google-defined id of the business entity
required field if you don't specify keyword or place_id
example:194604053573767737
learn more about the identifier in this help center article
optional field
number of reviews in SERP
we strongly recommend setting the parsing depth in the multiples of twenty, because our systems processes twenty reviews in a row
default value: 20
maximum value: 1000
Setting depth above 20 may result in additional charges if the search engine returns more than 20 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field if you don't specify cid or place_id
the keyword you specify should indicate the name of the local establishment;
you can specify up to 700 characters in the keyword filed;
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’, the charge per task will be multiplied by 5
Note: queries containing the ‘cache:’ parameter are not supported and will return a validation errorkeyword and keywords fields in DataForSEO APIs in this Help Center article
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to the https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to the https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you don't specify keyword or cid
example:GhIJQWDl0CIeQUARxks3icF8U8A
learn more about the identifier in this help center article
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleHotelInfoLiveAdvancedRequestInfo":{"properties":{"adults":{"description":"number of adults
optional field
if you don't specify this field, two adults will be used by default
example:1","type":["integer","null"]},"check_in":{"description":"check-in date
optional field
if you don't specify this field, tomorrow's date will be used by default;
the value must not be earlier than today's date
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"check_out":{"description":"check-out date
optional field
if you don't specify this field, our system will apply the date of two days from now by default;
Note: the value cannot be less than or equal to check_in;
the range between check_in and check_out values cannot exceed 30 days
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"children":{"description":"number and age of children
optional field
if you don't specify this field, no children will be included in the search;[14]
set the following value if you want to include one 13-years-old child and one 8-years-old child:[13,8]","items":{"type":"string"},"type":["array","null"]},"currency":{"description":"currency
optional field
example:\"USD\"","type":["string","null"]},"hotel_identifier":{"description":"unique hotel identifier
required field
unique identifier of a hotel entity in Google search;
you can obtain the value by making a request to Advanced Google SERP API (enclosed in the hotels element of the response), or the Hotel Searches endpoint of Business Data API
example:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"load_prices_by_dates":{"description":"load hotel stay prices by dates
optional field
if you specify this parameter with true, the response will include the prices_by_dates array with hotel stay prices divided by dates
if you use this parameter, you will be charged double the base price for a request","type":["boolean","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude, longitude\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
Note: if the coordinates are used to set a location, the search will occur in the nearest settlement;
example:53.476225,-2.243572n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"prices_date_range":{"description":"predefined period for retrieving daily price data
optional field
to use this parameter, you must specify load_prices_by_dates with true
if the prices_start_date is not specified, the start date is set to check_in date
possible values: month, three_months, six_months, year
default value: month","type":["string","null"]},"prices_end_date":{"description":"end date to load prices by dates
optional field
to use this parameter, you must specify load_prices_by_dates with true
if this parameter is not specified, you will get prices by date for the month
date format: yyyy-mm-dd
example:2025-05-21","type":["string","null"]},"prices_start_date":{"description":"start date to load prices by dates
optional field
to use this parameter, you must specify load_prices_by_dates with true
if this parameter is not specified, the start date is set to check_in date
date format: yyyy-mm-dd
example:2025-05-20","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleHotelInfoLiveHtmlRequestInfo":{"properties":{"adults":{"description":"number of adults
optional field
if you don't specify this field, two adults will be used by default
example:1","type":["integer","null"]},"check_in":{"description":"check-in date
optional field
if you don't specify this field, tomorrow's date will be used by default;
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"check_out":{"description":"check-out date
optional field
if you don't specify this field, our system will apply the date of two days from now by default;
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"children":{"description":"number and age of children
optional field
if you don't specify this field, no children will be included in the search;[14]
set the following value if you want to include one 13-years-old child and one 8-years-old child:[13,8]","items":{"type":"string"},"type":["array","null"]},"currency":{"description":"currency
optional field
example:\"USD\"","type":["string","null"]},"hotel_identifier":{"description":"unique hotel identifier
required field
unique identifier of a hotel entity in Google search;
you can obtain the value by making a request to Advanced Google SERP API (enclosed in the hotels element of the response), or the Hotel Searches endpoint of Business Data API
example:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
Note: if the coordinates are used to set a location, the search will occur in the nearest settlement;
example:53.476225,-2.243572n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data array of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleHotelInfoTaskPostRequestInfo":{"properties":{"adults":{"description":"number of adults
optional field
if you don't specify this field, two adults will be used by default
example:1","type":["integer","null"]},"check_in":{"description":"check-in date
optional field
if you don't specify this field, tomorrow's date will be used by default;
the value must not be earlier than today's date
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"check_out":{"description":"check-out date
optional field
if you don't specify this field, our system will apply the date of two days from now by default;
Note: the value cannot be less than or equal to check_in;
the range between check_in and check_out values cannot exceed 30 days
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"children":{"description":"number and age of children
optional field
if you don't specify this field, no children will be included in the search;[14]
set the following value if you want to include one 13-years-old child and one 8-years-old child:[13,8]","items":{"type":"string"},"type":["array","null"]},"currency":{"description":"currency
optional field
example:\"USD\"","type":["string","null"]},"hotel_identifier":{"description":"unique hotel identifier
required field if you don't specify keyword
if you use this field, you don't need to specify keyword
unique identifier of a hotel entity in Google search;
you can obtain the value by making a request to Advanced Google SERP API (enclosed in the hotels_pack element of the response), or the Hotel Searches endpoint of Business Data API
example:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE","type":"string"},"keyword":{"description":"keyword
required field if you don't specify hotel_identifier
if you use this field, you don't need to specify hotel_identifier
the keyword you specify should indicate the name of the hotel entity
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"load_prices_by_dates":{"description":"load hotel stay prices by dates
optional field
if you specify this parameter with true, the response will include the prices_by_dates array with hotel stay prices divided by dates
if you use this parameter, you will be charged double the base price for a request","type":["boolean","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
Note: if the coordinates are used to set a location, the search will occur in the nearest settlement;
example:53.476225,-2.243572n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified;
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable;
we will set the necessary values before sending the request;
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified;
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request;
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
to use this parameter, you must specify load_prices_by_dates with true
if the prices_start_date is not specified, the start date is set to check_in date
possible values: month, three_months, six_months, year
default value: month","type":["string","null"]},"prices_end_date":{"description":"end date to load prices by dates
optional field
to use this parameter, you must specify load_prices_by_dates with true
if this parameter is not specified, you will get prices by date for the month
date format: yyyy-mm-dd
example:2025-05-21","type":["string","null"]},"prices_start_date":{"description":"start date to load prices by dates
optional field
to use this parameter, you must specify load_prices_by_dates with true
if this parameter is not specified, the start date is set to check_in date
date format: yyyy-mm-dd
example:2025-05-20","type":["string","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255;
you can use this parameter to identify the task and match it with the result;
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleHotelSearchesLiveRequestInfo":{"properties":{"adults":{"description":"number of adults
optional field
if you don't specify this field, the default value of 2 will be applied;
note that you can specify up to 6 persons including both adults and children
example:1","type":["integer","null"]},"amenities":{"description":"hotel amenities
optional field
you can use this field to specify different hotel amenities
example: [
\"free_parking\",
\"pets_allowed\"
]
possible values:
`\"air_conditioning\",
\"all_inclusive_available\",
\"bar\",
\"free_breakfast\",
\"fitness_center\",
\"kid_friendly\",
\"free_parking\",
\"pets_allowed\",
\"pool\",
\"restaurant\",
\"room_service\",
\"spa\",
\"free_wifi\",
\"parking\",
\"indoor_pool\",
\"outdoor_pool\",
\"wheelchair_accessible\",
\"beach_access\"`","items":{"type":"string"},"type":["array","null"]},"check_in":{"description":"check-in date
optional field
if you don't specify this field, tomorrow's date will be used by default;
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"
Note: the value cannot precede the today's date","type":["string","null"]},"check_out":{"description":"check-out date
optional field
if you don't specify this field, our system will apply the date of two days from now by default;
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"
Note: the value cannot be less than or equal to check_in;
the range between check_in and check_out values cannot exceed 30 days","type":["string","null"]},"children":{"description":"number and age of children
optional field
if you don't specify this field, no children will be included in the search;
age of child can be from 0 to 17;
note that you can specify up to 6 persons including both adults and children
set the following value if you want to include one 14-year-old child:[14]
set the following value if you want to include one 13-year-old child and one 8-year-old child:[13,8]","items":{"type":"string"},"type":["array","null"]},"currency":{"description":"currency
optional field
example:\"USD\"","type":["string","null"]},"depth":{"description":"parsing depth
optional field
number of results in Google Hotels
default value: 18 organic results
max value: 140
Note: your account will be billed per each 18 organic results regardless of paid listings in the response;
thus, setting a depth above 18 may result in additional charges if Google Hotels return more than 18 results;
if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance","type":["integer","null"]},"free_cancellation":{"description":"hotels with a free cancellation
optional field
set this field to true if you want to get the list of hotels with free cancellation of reservations
default value: false","type":["boolean","null"]},"is_vacation_rentals":{"description":"search for vacation rentals
optional field
set this field to true if you want to get the list of vacation rentals instead of hotels
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
optional field
the keyword you specify is used to search for the list of hotels;
if you don't use this field, we will return the list of hotels found in a specified location;
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
Note: in order to obtain accurate search results, the location name is appended to the keyword automaticallykeyword and keywords fields in DataForSEO APIs in this Help Center article","type":["string","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
Note: if the coordinates are used to set a location, the search will occur in the nearest settlement
example:53.476225,-2.243572n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom
Note: in order to obtain accurate search results, the location_name you specify will be automatically appended to the keyword","type":"string"},"max_price":{"description":"maximum price per night
optional field
the currency of this value depends on the currency field
example:600","type":["integer","null"]},"min_price":{"description":"minimum price per night
optional field
the currency of this value depends on the currency field
example:100","type":["integer","null"]},"min_rating":{"description":"minimum rating
optional field
you can use this field to specify guest rating higher than a certain value
example:2.5","type":["number","null"]},"search_this_area":{"description":"show hotels from the displayed area
optional field
can take the values: true, false
default value: true
if set to false the search_this_area mode will be turned off
Note: if the search_this_area mode is turned off, the location_name won't be appended to the keyword during search
learn more about this parameter on our Help Center","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
you can use this field to sort the results
possible types of sorting:relevance – sort by most relevantlowest_price – sort by the lowest pricehighest_rating – sort by highest ratingmost_reviewed – sort by most reviewed
default value: relevance","type":["string","null"]},"stars":{"description":"hotel stars
optional field
set this field to [5] if you want to get the list of 5-star hotels only
example:[3,4,5]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleHotelSearchesTaskPostRequestInfo":{"properties":{"adults":{"description":"number of adults
optional field
if you don't specify this field, the default value of 2 will be applied;
note that you can specify up to 6 persons including both adults and children
example:1","type":["integer","null"]},"amenities":{"description":"hotel amenities
optional field
you can use this field to specify different hotel amenities
example: [
\"free_parking\",
\"pets_allowed\"
]
possible values:\"air_conditioning\",","items":{"type":"string"},"type":["array","null"]},"check_in":{"description":"check-in date
\"all_inclusive_available\",
\"bar\",
\"free_breakfast\",
\"fitness_center\",
\"kid_friendly\",
\"free_parking\",
\"pets_allowed\",
\"pool\",
\"restaurant\",
\"room_service\",
\"spa\",
\"free_wifi\",
\"parking\",
\"indoor_pool\",
\"outdoor_pool\",
\"wheelchair_accessible\",
\"beach_access\"
optional field
if you don't specify this field, tomorrow's date will be used by default;
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"
Note: the value cannot precede the today's date","type":["string","null"]},"check_out":{"description":"check-out date
optional field
if you don't specify this field, our system will apply the date of two days from now by default;
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"
Note: the value cannot be less than or equal to check_in;
the range between check_in and check_out values cannot exceed 30 days","type":["string","null"]},"children":{"description":"number and age of children
optional field
if you don't specify this field, no children will be included in the search;
age of child can be from 0 to 17;
note that you can specify up to 6 persons including both adults and children
set the following value if you want to include one 14-year-old child:[14]
set the following value if you want to include one 13-year-old child and one 8-year-old child:[13,8]","items":{"type":"string"},"type":["array","null"]},"currency":{"description":"currency
optional field
example:\"USD\"","type":["string","null"]},"depth":{"description":"parsing depth
optional field
number of results in Google Hotels
default value: 18 organic results
max value: 140
Note: your account will be billed per each 18 organic results regardless of paid listings in the response;
thus, setting a depth above 18 may result in additional charges if Google Hotels return more than 18 results;
if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance","type":["integer","null"]},"free_cancellation":{"description":"hotels with a free cancellation
optional field
set this field to true if you want to get the list of hotels with free cancellation of reservations
default value: false","type":["boolean","null"]},"is_vacation_rentals":{"description":"search for vacation rentals
optional field
set this field to true if you want to get the list of vacation rentals instead of hotels
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
optional field
the keyword you specify is used to search for the list of hotels;
if you don't use this field, we will return the list of hotels found in a specified location;
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
Note: in order to obtain accurate search results, the location name is appended to the keyword automaticallykeyword and keywords fields in DataForSEO APIs in this Help Center article","type":["string","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
Note: if the coordinates are used to set a location, the search will occur in the nearest settlement;
example:53.476225,-2.243572","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom
Note: in order to obtain accurate search results, the location_name you specify will be automatically appended to the keyword","type":"string"},"max_price":{"description":"maximum price per night
optional field
the currency of this value depends on the currency field
example:600","type":["integer","null"]},"min_price":{"description":"minimum price per night
optional field
the currency of this value depends on the currency field
example:100","type":["integer","null"]},"min_rating":{"description":"minimum rating
optional field
you can use this field to specify guest rating higher than a certain value
example:2.5","type":["number","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"search_this_area":{"description":"show hotels from the displayed area
optional field
can take the values: true, false
default value: true
if set to false the search_this_area mode will be turned off
Note: if the search_this_area mode is turned off, the location_name won't be appended to the keyword during search
learn more about this parameter on our Help Center","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
you can use this field to sort the results
possible types of sorting:relevance – sort by most relevantlowest_price – sort by the lowest pricehighest_rating – sort by highest ratingmost_reviewed – sort by most reviewed
default value: relevance","type":["string","null"]},"stars":{"description":"hotel stars
optional field
set this field to [5] if you want to get the list of 5-star hotels only
example:[3,4,5]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleMyBusinessInfoLiveRequestInfo":{"properties":{"keyword":{"description":"keyword
required field
the keyword you specify should indicate the name of the local establishment
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”; cid - a unique, google-defined id of the business entity;place_id - an identifier of the business entity in Google Maps;cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acid and place_id identifiers in this help center articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskPostRequestInfo":{"properties":{"keyword":{"description":"keyword
required field
the keyword you specify should indicate the name of the local establishment
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”; cid - a unique, google-defined id of the business entity;place_id - an identifier of the business entity in Google Maps;cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acid and place_id identifiers in this help center articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of updates in SERP
we strongly recommend setting the parsing depth in the multiples of ten, because our systems processes ten updates in a row
please note that Google returns 4490 updates maximum
default value: 10","type":["integer","null"]},"keyword":{"description":"keyword
required field
the keyword you specify should indicate the name of the local establishment
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;this field can also be used to pass cid (unique, google-defined id of the business entity) or place_id (identifier of the business entity in Google Maps) parameters
example:cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acid and place_id identifiers in this help center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to the https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to the https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleQuestionsAndAnswersLiveRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 20
max value: 100
Your account will be billed per each SERP containing up to 20 results;
Setting depth above 20 may result in additional charges if the search engine returns more than 20 results;
If the specified depth is higher than the number of questions in the response, the difference will be refunded automatically to your account balance;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
the keyword you specify should indicate the name of the local establishment
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”; cid - a unique, google-defined id of the business entity;place_id - an identifier of the business entity in Google Maps;cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acid and place_id identifiers in this help center articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of question rows in the result
default value: 20
max value: 700
Your account will be billed per each SERP containing up to 20 results;
Setting depth above 20 may result in additional charges if the search engine returns more than 20 results;
If the specified depth is higher than the number of questions in the response, the difference will be refunded automatically to your account balance;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
the keyword you specify should indicate the name of the local establishment
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”; cid - a unique, google-defined id of the business entity;place_id - an identifier of the business entity in Google Maps;cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acid and place_id identifiers in this help center articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
learn more on our Help Center","type":["string","null"]},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataGoogleReviewsTaskPostRequestInfo":{"properties":{"cid":{"description":"unique, google-defined id of the business entity
required field if you don't specify keyword or place_id
example:194604053573767737
learn more about the identifier in this help center article","type":"string"},"depth":{"description":"parsing depth
optional field
number of reviews in SERP
we strongly recommend setting the parsing depth in the multiples of ten, because our systems processes ten reviews in a row
default value: 10
maximum value: 4490
Your account will be billed per each SERP containing up to 10 results;
Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field if you don't specify cid or place_id
the keyword you specify should indicate the name of the local establishment;
you can specify up to 700 characters in the keyword filed;
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’, the charge per task will be multiplied by 5
Note: queries containing the ‘cache:’ parameter are not supported and will return a validation errorkeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_by making a separate request to the https://api.dataforseo.com/v3/business_data/google/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with language_name by making a separate request to the https://api.dataforseo.com/v3/business_data/google/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you don't specify keyword or cid
example:GhIJQWDl0CIeQUARxks3icF8U8A
learn more about the identifier in this help center article","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"sort_by":{"description":"results sorting parameters
optional field
you can use this field to sort the results
possible types of sorting:newest – sort by newest firsthighest_rating – sort by highest ratinglowest_rating – sort by lowest ratingrelevant – sort by relevance
default value: relevant","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataTripadvisorReviewsTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of reviews in SERP;
we strongly recommend setting the parsing depth in the multiples of ten, because our systems processes ten reviews in a row;
default value: 10;
max value: 4490
Your account will be billed per each SERP containing up to 10 results;
Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field if you do not specify url_path
the keyword you specify should indicate a name of an existing business or prominent place on Tripadvisor;
you can specify up to 700 characters in the keyword filed;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”","type":"string"},"language_code":{"description":"search engine language code
optional field
if you use this field, your account will be charged for one extra request
you can receive the list of available languages with language_code by making a separate request to the https://api.dataforseo.com/v3/business_data/tripadvisor/languages
example:en
You will be additionally charged for setting a language parameter in this endpoint.
The cost can be calculated on the Pricing page.","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
if you use this field, your account will be charged for one extra request
you can receive the list of available languages with language_name by making a separate request to the https://api.dataforseo.com/v3/business_data/tripadvisor/languages
example:English
You will be additionally charged for setting a language parameter in this endpoint.
The cost can be calculated on the Pricing page.","type":["string","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name or url_path
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/tripadvisor/locations
example:1003854","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or url_path
you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_data/tripadvisor/locations
example:London,England,United Kingdom","type":"string"},"months":{"description":"filter by months when a traveler made a visit
optional field
possible values: january, february, march, april, may, april, june, july, august, september, october, november, december
you can specify several values at once","items":{"type":"string"},"type":["array","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"ratings":{"description":"Tripadvisor traveler rating for a place of interest
optional field
rating based on the written reviews by a traveler after they visited a place.
possible values: excellent, very_good, average, poor, terrible
you can specify several values at once","items":{"type":"string"},"type":["array","null"]},"sort_by":{"description":"results sorting parameters
optional field
you can use this field to sort the results;
possible types of sorting:most_recentdetailed_reviews","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"translate_reviews":{"description":"translate reviews according to the URL path
optional field
if set to true, returned reviews will be translated to the language matching the specified url_path;
for example, if url_path contains tripadvisor.it and translate_reviews is true, reviews will be translated to the Italian language;
default value: true
you can learn more about how reviews are translated in this Help Center article","type":["boolean","null"]},"url_path":{"description":"URL path of the business entity
required field if you do not specify keyword
URL path to the Tripadvisor page of the business entity;
examples:Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.htmlhttps://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html","type":"string"},"visit_type":{"description":"filter by type of travelers who left a review
optional field
possible values: families, couples, solo, business, friends
you can specify several values at once","items":{"type":"string"},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataTripadvisorSearchTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of search results to be returned from the API response
we strongly recommend setting the parsing depth in the multiples of thirty because our systems processes thirty search results in a row;
default value: 30;
maximum value: 210
Setting depth above 30 may result in additional charges if the search engine returns more than 30 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
the keyword you specify should indicate a business category, company name, or a prominent place;
you can specify up to 700 characters in the keyword filed;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/tripadvisor/locations
example:1003854","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_data/tripadvisor/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataTrustpilotReviewsTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of reviews to be returned from the API response
we strongly recommend setting the parsing depth in the multiples of twenty, because our system processes twenty reviews in a row
default value: 20
maximum value: 200
Your account will be billed per each SERP containing up to 20 results;
Setting depth above 20 may result in additional charges if the search engine returns more than 20 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"domain":{"description":"domain of the local establishment
required field
domain of the local establishment on Trustpilot;
you can find the domain in the URL of every business listed on Trustpilot
example:www.thepearlsource.comhttps://www.trustpilot.com/review/www.thepearlsource.com","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"sort_by":{"description":"results sorting parameter
optional field
you can use this field to sort the results;
possible sorting parameters:recency — most recent reviews first;relevance — most relevant reviews first;
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_BusinessDataTrustpilotSearchTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of search results to be returned from the API response
we strongly recommend setting the parsing depth in the multiples of twenty because our systems processes twenty search results in a row;
default value: 10;
maximum value: 140
Your account will be billed per each SERP containing up to 10 results;
Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
the keyword you specify should indicate a business category or company name;
you can specify up to 700 characters in the keyword filed;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_ContentAnalysisCategoryTrendsLiveRequestInfo":{"properties":{"category_code":{"description":"target category code
required field
to obtain a full list of available categories, refer to the Categories endpoint","type":["integer","null"]},"date_from":{"description":"starting date of the time range
required field
minimum value: 2022-10-31
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":"string"},"date_group":{"description":"time range which will be used to group the results
optional field
default value: month
possible values: day, week, month","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"initial_dataset_filters":{"description":"initial dataset filtering parameters
optional field
initial filtering parameters that apply to fields in the Search endpoint;
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"domain\",\"<>\", \"logitech.com\"][[\"domain\",\"<>\",\"logitech.com\"],\"and\",[\"content_info.connotation_types.negative\",\">\",1000]][[\"domain\",\"<>\",\"logitech.com\"]],
\"and\",
[[\"content_info.connotation_types.negative\",\">\",1000],
\"or\",
for more information about filters, please refer to Content Analysis API - Filters
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:top_domainstext_categoriespage_categoriescountrieslanguages
default value: 1
maximum value: 20","type":["integer","null"]},"page_type":{"description":"target page types
optional field
use this parameter to filter the dataset by page types
possible values: \"ecommerce\", \"news\", \"blogs\", \"message-boards\", \"organization\"","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
possible grouping types:as_is - returns data on all citations for the target category_codeone_per_domain - returns data on one citation of the category_code per domain
default value: as_is","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_ContentAnalysisPhraseTrendsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
required field
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":"string"},"date_group":{"description":"time range which will be used to group the results
optional field
default value: month
possible values: day, week, month","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"initial_dataset_filters":{"description":"initial dataset filtering parameters
optional field
initial filtering parameters that apply to fields in the Search endpoint;
you can add several filters at once (8 filters maximum);
you should set a logical operator and, or between the conditions;
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters;
example:[\"domain\",\"<>\", \"logitech.com\"][[\"domain\",\"<>\",\"logitech.com\"],\"and\",[\"content_info.connotation_types.negative\",\">\",1000]][[\"domain\",\"<>\",\"logitech.com\"]],
\"and\",
[[\"content_info.connotation_types.negative\",\">\",1000],
\"or\",
for more information about filters, please refer to Content Analysis API - Filters
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:top_domainstext_categoriespage_categoriescountrieslanguages
default value: 1
maximum value: 20","type":["integer","null"]},"keyword":{"description":"target keyword
required field
UTF-8 encoding
the keywords will be converted to a lowercase format;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example: \"keyword\": \"\\\"tesla palo alto\\\"\"keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"keyword_fields":{"additionalProperties":{"type":["string","null"]},"description":"target keyword fields and target keywords
optional field
use this parameter to filter the dataset by keywords that certain fields should contain;
fields you can specify: title, main_title, previous_title, snippet
you can indicate several fields;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:
`\"keyword_fields\": {
\"snippet\": \"\\\"logitech mouse\\\"\",
\"main_title\": \"sale\"
}`","type":["object","null"]},"page_type":{"description":"target page types
optional field
use this parameter to filter the dataset by page types
possible values: \"ecommerce\", \"news\", \"blogs\", \"message-boards\", \"organization\"","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
possible grouping types:as_is - returns data on all citations for the target keywordone_per_domain - returns data on one citation of the keyword per domain
default value: as_is","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_ContentAnalysisRatingDistributionLiveRequestInfo":{"properties":{"initial_dataset_filters":{"description":"initial dataset filtering parameters
optional field
initial filtering parameters that apply to fields in the Search endpoint
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"domain\",\"<>\", \"logitech.com\"][[\"domain\",\"<>\",\"logitech.com\"],\"and\",[\"content_info.connotation_types.negative\",\">\",1000]][[\"domain\",\"<>\",\"logitech.com\"]],
\"and\",
[[\"content_info.connotation_types.negative\",\">\",1000],
\"or\",
for more information about filters, please refer to Content Analysis API - Filters
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:top_domainstext_categoriespage_categoriescountrieslanguages
default value: 1
maximum value: 20","type":["integer","null"]},"keyword":{"description":"target keyword
required field
UTF-8 encoding
the keywords will be converted to a lowercase format;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example: \"keyword\": \"\\\"tesla palo alto\\\"\"keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"keyword_fields":{"additionalProperties":{"type":["string","null"]},"description":"target keyword fields and target keywords
optional field
use this parameter to filter the dataset by keywords that certain fields should contain;
fields you can specify: title, main_title, previous_title, snippet
you can indicate several fields;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:
`\"keyword_fields\": {
\"snippet\": \"\\\"logitech mouse\\\"\",
\"main_title\": \"sale\"
}`","type":["object","null"]},"page_type":{"description":"target page types
optional field
use this parameter to filter the dataset by page types
possible values: \"ecommerce\", \"news\", \"blogs\", \"message-boards\", \"organization\"","items":{"type":"string"},"type":["array","null"]},"positive_connotation_threshold":{"description":"positive connotation threshold
optional field
specified as the probability index threshold for positive sentiment related to the citation content
if you specify this field, connotation_types object in the response will only contain data on citations with positive sentiment probability more than or equal to the specified value
possible values: from 0 to 1
default value: 0.4","type":["number","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
possible grouping types:as_is - returns all citations for the target keywordone_per_domain - returns one citation of the keyword per domain
default value: as_is","type":["string","null"]},"sentiments_connotation_threshold":{"description":"sentiment connotation threshold
optional field
specified as the probability index threshold for sentiment connotations related to the citation content
if you specify this field, sentiment_connotations object in the response will only contain data on citations where the probability per each sentiment is more than or equal to the specified value
possible values: from 0 to 1
default value: 0.4","type":["number","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_ContentAnalysisSearchLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"country\",\"=\", \"US\"][[\"domain_rank\",\">\",800],\"and\",[\"content_info.connotation_types.negative\",\">\",0.9]][[\"domain_rank\",\">\",800],
\"and\",
[[\"page_types\",\"has\",\"ecommerce\"],
\"or\",
for more information about filters, please refer to Content Analysis API - Filters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"keyword":{"description":"target keyword
required field
UTF-8 encoding
the keywords will be converted to a lowercase format;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:
`\"keyword\": \"\\\"tesla palo alto\\\"\"`keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"keyword_fields":{"additionalProperties":{"type":["string","null"]},"description":"target keyword fields and target keywords
optional field
use this parameter to filter the dataset by keywords that certain fields should contain;
fields you can specify: title, main_title, previous_title, snippet
you can indicate several fields;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:
`\"keyword_fields\": {
\"snippet\": \"\\\"logitech mouse\\\"\",
\"main_title\": \"sale\"
}\"`","type":["object","null"]},"limit":{"description":"the maximum number of returned citations
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned citations
optional field
default value: 0
if you specify the 10 value, the first ten citations in the results array will be omitted and the data will be provided for the successive citations
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
optional field
provided in the identical field of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"content_info.sentiment_connotations.anger,desc\"]
default rule:[\"content_info.sentiment_connotations.anger,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"content_info.sentiment_connotations.anger,desc\",\"keyword_data.keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"page_type":{"description":"target page types
optional field
use this parameter to filter the dataset by page types
possible values: \"ecommerce\", \"news\", \"blogs\", \"message-boards\", \"organization\"","items":{"type":"string"},"type":["array","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the domain_rank, and url_rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
possible grouping types:as_is - returns all citations for the target keywordone_per_domain - returns one citation of the keyword per domain
default value: as_is","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_ContentAnalysisSentimentAnalysisLiveRequestInfo":{"properties":{"initial_dataset_filters":{"description":"initial dataset filtering parameters\noptional field\ninitial filtering parameters that apply to fields in the Search endpoint\nyou can add several filters at once (8 filters maximum)\nyou should set a logical operator and, or between the conditions\nthe following operators are supported:\nregex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match\nyou can use the % operator with like and not_like to match any string of zero or more characters\nexample:\n[\"domain\",\"<>\", \"logitech.com\"]\n[[\"domain\",\"<>\",\"logitech.com\"],\"and\",[\"content_info.connotation_types.negative\",\">\",1000]]\n[[\"domain\",\"<>\",\"logitech.com\"]],\n\"and\",\n[[\"content_info.connotation_types.negative\",\">\",1000],\n\"or\",\n[\"content_info.text_category\",\"has\",10994]]]\nfor more information about filters, please refer to Content Analysis API – Filters\nlearn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays\noptional field\nyou can use this field to limit the number of elements within the following arrays:\ntop_domains\ntext_categories\npage_categories\ncountries\nlanguages\ndefault value: 1\nmaximum value: 20","type":["integer","null"]},"keyword":{"description":"target keyword\nrequired field\nUTF-8 encoding\nthe keywords will be converted to a lowercase format;\nNote: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;\nexample:\n\"keyword\": \"\\\"tesla palo alto\\\"\"\nlearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"keyword_fields":{"additionalProperties":{"type":["string","null"]},"description":"target keyword fields and target keywords\noptional field\nuse this parameter to filter the dataset by keywords that certain fields should contain;\nfields you can specify: title, main_title, previous_title, snippet\nyou can indicate several fields;\nNote: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;\nexample:\n\"keyword_fields\": {\n \"snippet\": \"\\\"logitech mouse\\\"\",\n \"main_title\": \"sale\"\n}","type":["object","null"]},"page_type":{"description":"target page types\noptional field\nuse this parameter to filter the dataset by page types\npossible values:\n\"ecommerce\", \"news\", \"blogs\", \"message-boards\", \"organization\"","items":{"type":"string"},"type":["array","null"]},"positive_connotation_threshold":{"description":"positive connotation threshold\noptional field\nspecified as the probability index threshold for positive sentiment related to the citation content\nif you specify this field, connotation_types object in the response will only contain data on citations with positive sentiment probability more than or equal to the specified value\npossible values: from 0 to 1\ndefault value: 0.4","type":["number","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank values\noptional field\nyou can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale\npossible values:\none_hundred — rank values are displayed on a 0–100 scale\none_thousand — rank values are displayed on a 0–1000 scale\ndefault value: one_thousand\nlearn more about how this parameter works in this Help Center article","type":["string","null"]},"sentiments_connotation_threshold":{"description":"sentiment connotation threshold\noptional field\nspecified as the probability index threshold for sentiment connotations related to the citation content\nif you specify this field, sentiment_connotations object in the response will only contain data on citations where the probability per each sentiment is more than or equal to the specified value\npossible values: from 0 to 1\ndefault value: 0.4","type":["number","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_ContentAnalysisSummaryLiveRequestInfo":{"properties":{"initial_dataset_filters":{"description":"initial dataset filtering parameters
optional field
initial filtering parameters that apply to fields in the Search endpoint
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"domain\",\"<>\", \"logitech.com\"][[\"domain\",\"<>\",\"logitech.com\"],\"and\",[\"content_info.connotation_types.negative\",\">\",1000]][[\"domain\",\"<>\",\"logitech.com\"]],
\"and\",
[[\"content_info.connotation_types.negative\",\">\",1000],
\"or\",
for more information about filters, please refer to Content Analysis API - Filters
learn more about the initial dataset filters in this help center article.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:top_domainstext_categoriespage_categoriescountrieslanguages
default value: 1
maximum value: 20","type":["integer","null"]},"keyword":{"description":"target keyword
required field
UTF-8 encoding
the keywords will be converted to a lowercase format;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example: \"keyword\": \"\\\"tesla palo alto\\\"\"keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"keyword_fields":{"additionalProperties":{"type":["string","null"]},"description":"target keyword fields and target keywords
optional field
use this parameter to filter the dataset by keywords that certain fields should contain;
fields you can specify: title, main_title, previous_title, snippet
you can indicate several fields;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:\"keyword_fields\": {","type":["object","null"]},"page_type":{"description":"target page types
\"snippet\": \"\\\"logitech mouse\\\"\",
\"main_title\": \"sale\"
}
optional field
use this parameter to filter the dataset by page types
possible values: \"ecommerce\", \"news\", \"blogs\", \"message-boards\", \"organization\"","items":{"type":"string"},"type":["array","null"]},"positive_connotation_threshold":{"description":"positive connotation threshold
optional field
specified as the probability index threshold for positive sentiment related to the citation content
if you specify this field, connotation_types object in the response will only contain data on citations with positive sentiment probability more than or equal to the specified value
possible values: from 0 to 1
default value: 0.4","type":["number","null"]},"rank_scale":{"description":"defines the scale used for calculating and displaying the rank values
optional fieldone_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaleone_thousand
optional field
specified as the probability index threshold for sentiment connotations related to the citation content
if you specify this field, sentiment_connotations object in the response will only contain data on citations where the
probability per each sentiment is more than or equal to the specified value
possible values: from 0 to 1
default value: 0.4","type":["number","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000;
the keywords will be converted to lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Note: this endpoint currently supports these locations and languages only;
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Note: this endpoint currently supports these locations and languages only;
example:English","type":"string"},"location_code":{"description":"location code
required field if don't specify location_name
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports these locations and languages only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if don't specify location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the following locations and languages only:Australia - 2036, enAustria - 2040, deCanada - 2124, enEgypt - 2818, arFrance - 2250, frGermany - 2276, deIndia - 2356, enItaly - 2380, itMexico - 2484, esNetherlands - 2528, nlSaudi Arabia - 2682, arSingapore - 2702, enSpain - 2724, esUnited Arab Emirates - 2784, arUnited Kingdom - 2826, enUnited States - 2840, en
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveRequestInfo":{"properties":{"asin":{"description":"product ID
required field
unique product identifier (ASIN) on Amazon;
you can receive the asin parameter by making a separate request to the Amazon Products endpoint","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, ilike, not_ilike, like, not_like, match, not_match
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
example:[\"full_metrics.amazon_serp.pos_1\",\">\", 20]
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of products in the results array
optional field
default value: 100;
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if don't specify location_name
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if don't specify location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned product competitors
optional field
default value: 0
if you specify the 10 value, the first ten product competitors in the results array will be omitted and the data will be provided for the successive product competitors","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:[\"full_metrics.amazon_serp.pos_1,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"full_metrics.amazon_serp.pos_1,desc\",\"avg_position,desc\"]
default rule:[\"ranked_serp_element.serp_item.rank_group,asc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveRequestInfo":{"properties":{"asins":{"additionalProperties":{"type":["string","null"]},"description":"asins of target products
required field
product IDs of the products for which you need to find keyword intersections;
specify the ASINs as in the following example:\"asins\": {
\"1\": \"019005476X\",
\"2\": \"0190074442\"
}
the maximum number of ASINs you can specify in this object is 20;
learn more about the parameter on this help center page","type":["object","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, ilike, not_ilike, like, not_like, match, not_match
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
example:[\"avg_position\",\"<\", 10]
optional field
possible values: union, intersect;
default value: intersect;
learn more about the parameter in this help center guide","type":["string","null"]},"language_code":{"description":"language code
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of products in the results array
optional field
default value: 100;
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if don't specify location_name
you can receive the list of available locations with their location_code by making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if don't specify location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:[\"sum_position,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"intersections,desc\",\"avg_position,asc\"]
default rule:[\"intersections,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveRequestInfo":{"properties":{"asins":{"description":"product IDs to compare
required field
product IDs to receive ranking data for;
the maximum number of ASINs you can specify in this array is 1000;
you can receive the asin parameter by making a separate request to the Amazon Products endpoint
example:B01LW2SL7R","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"location_code":{"description":"location code
required field if don't specify location_name
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if don't specify location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveRequestInfo":{"properties":{"asin":{"description":"product ID
required field
unique product identifier (ASIN) on Amazon;
you can receive the asin parameter by making a separate request to the Amazon Products endpoint","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"keyword_data.keyword_info.search_volume\",\"in\",[100,1000]];
optional field
if set to true only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"language_code":{"description":"language code
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of products in the results array
optional field
default value: 100;
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if don't specify location_name
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if don't specify location_code
you can receive the list of available locations with their location_name by making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:[\"keyword_data.keyword_info.competition,desc\"]
default rule:[\"ranked_serp_element.serp_item.rank_group,asc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword_data.keyword_info.search_volume,desc\",\"keyword_data.keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveRequestInfo":{"properties":{"depth":{"description":"keyword search depth
optional field
default value: 1;
number of the returned results depends on the value you set in this field;
you can specify a level from 0 to 4;
estimated number of keywords for each level (maximum):
0 - the keyword set in the keyword field
1 – 6 keywords
2 – 42 keywords
3 – 258 keywords
4 – 1554 keywords","type":["integer","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to_true only core keywords will be returned, all highly similar keywords will be excluded;
default value: falsen","type":["boolean","null"]},"include_seed_keyword":{"description":"include data for the seed keyword
optional field
if set to true, data for the seed keyword specified in the keyword field will be provided in the seed_keyword_data array of the response
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
required field
UTF-8 encoding
the keywords should be specified in the lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAppleAppCompetitorsLiveRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on App Store;
you can find the ID in the URL of every app listed on App Store;
example:
in the URL https://apps.apple.com/us/app/id835599320
the id is 835599320","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in
example:[\"intersections\",\">\",500][[\"competitor_metrics.app_store_search_organic.pos_1\",\"<>\",10],\"and\",[\"avg_position\",\">=\",\"10\"]][[[\"intersections\",\">=\",50],\"and\",[\"competitor_metrics.app_store_search_organic.pos_1\",\"in\",[1,5]]],
\"or\",
[\"sum_position\",\">=\",\"10000\"]]
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"limit":{"description":"the maximum number of returned apps
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned apps
optional field
default value: 0
if you specify the 10 value, the first ten apps in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
possible sorting types:asc - results will be sorted in the ascending order;desc - results will be sorted in the descending order;
you should use a comma to specify a sorting type;
example:[\"intersections,asc\"]
Note: you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"intersections,desc\",\"sum_position,asc\"][\"intersections,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAppleAppIntersectionLiveRequestInfo":{"properties":{"app_ids":{"additionalProperties":{"type":["string","null"]},"description":"ids of the target apps
required field
IDs of the target mobile applications on App Store;
you can find the ID in the URL of every app listed on App Store;
example:
in the URL https://apps.apple.com/us/app/id835599320
the id is 835599320;
the ids should be specified the following way:
`\"app_ids\": {
\"1\": \"686449807\",
\"2\": \"382617920\"
}`
if you specify a single ID here, the API will return results only for one application;
the maximum number of app IDs you can specify in this object is 20","type":["object","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in
example:[\"keyword_data.keyword_info.search_volume\",\">\",500][[\"keyword_data.keyword_info.search_volume\",\"<>\",500],\"and\",[intersection_result.382617920.rank_group\",\">=\",\"10\"]]
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
possible sorting types:asc - results will be sorted in the ascending order;desc - results will be sorted in the descending order;
you should use a comma to specify a sorting type;
example:[\"intersection_result.382617920.rank_absolute,asc\"]
Note: you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"intersection_result.382617920.rank_absolute,desc\",\"keyword_data.keyword_info.search_volume,asc\"]
default rule:[\"keyword_data.keyword_info.search_volume,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAppleBulkAppMetricsLiveRequestInfo":{"properties":{"app_ids":{"description":"ids of the apps
required field
IDs of mobile applications on App Store;
you can find the ID in the URL of every app listed on App Store;
example:
in the URL https://apps.apple.com/us/app/id835599320
the id is 835599320;
the maximum number of IDs you can specify in this field is 1000","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on App Store;
you can find the ID in the URL of every app listed on App Store;
example:
in the URL https://apps.apple.com/us/app/id835599320
the id is 835599320","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in
example:[\"keyword_data.keyword_info.search_volume\",\">\",500][[\"keyword_data.keyword_info.search_volume\",\"<>\",500],\"and\",[\"ranked_serp_element.serp_item.rank_group\",\">=\",\"10\"]]
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
possible sorting types:asc - results will be sorted in the ascending order;desc - results will be sorted in the descending order;
you should use a comma to specify a sorting type;
example:[\"ranked_serp_element.serp_item.rank_group,asc\"]
Note: you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"ranked_serp_element.serp_item.rank_group,desc\",\"keyword_data.keyword_info.search_volume,asc\"]
default rule:[\"keyword_data.keyword_info.search_volume,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleAppCompetitorsLiveRequestInfo":{"properties":{"app_id":{"description":"id of the app
required field
ID of the mobile application on Google Play;
you can find the ID in the URL of every app listed on Google Play;
example:
in the URL https://play.google.com/store/apps/details?id=org.telegram.messenger
the id is org.telegram.messenger","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in
example:[\"intersections\",\">\",500][[\"competitor_metrics.google_play_search_organic.pos_1\",\"<>\",10],\"and\",[\"avg_position\",\">=\",\"10\"]][[[\"intersections\",\">=\",50],\"and\",[\"competitor_metrics.google_play_search_organic.pos_1\",\"in\",[1,5]]],
\"or\",
[\"sum_position\",\">=\",\"10000\"]]
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"limit":{"description":"the maximum number of returned apps
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned apps
optional field
default value: 0
if you specify the 10 value, the first ten apps in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
possible sorting types:asc - results will be sorted in the ascending order;desc - results will be sorted in the descending order;
you should use a comma to specify a sorting type;
example:[\"intersections,asc\"]
Note: you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"intersections,desc\",\"sum_position,asc\"][\"intersections,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleAppIntersectionLiveRequestInfo":{"properties":{"app_ids":{"additionalProperties":{"type":["string","null"]},"description":"ids of the target apps
required field
IDs of the target mobile applications on Google Play;
you can find the ID in the URL of every app listed on Google Play;
example:
in the URL https://play.google.com/store/apps/details?id=org.telegram.messenger
the id is org.telegram.messenger;;
the ids should be specified the following way:\"app_ids\": {
\"1\": \"org.telegram.messenger\",
\"2\": \"com.zhiliaoapp.musically\"
}
if you specify a single ID here, the API will return results only for one application;
the maximum number of app IDs you can specify in this object is 20","type":["object","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in
example:[\"keyword_data.keyword_info.search_volume\",\">\",500][[\"keyword_data.keyword_info.search_volume\",\"<>\",500],\"and\",[intersection_result.382617920.rank_group\",\">=\",\"10\"]]
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
possible sorting types:asc - results will be sorted in the ascending order;desc - results will be sorted in the descending order;
you should use a comma to specify a sorting type;
example:[\"intersection_result.382617920.rank_absolute,asc\"]
Note: you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"intersection_result.382617920.rank_absolute,desc\",\"keyword_data.keyword_info.search_volume,asc\"]
default rule:[\"keyword_data.keyword_info.search_volume,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleBulkAppMetricsLiveRequestInfo":{"properties":{"app_ids":{"description":"ids of the app
required field
IDs of the mobile applications on Google Play;
you can find the ID in the URL of every app listed on Google Play;
example:
in the URL https://play.google.com/store/apps/details?id=org.telegram.messenger
the id is org.telegram.messenger;
the maximum number of IDs you can specify in this field is 1000","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000
the keywords will be converted to lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"location_code":{"description":"location code
required field if don't specify location_name
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if don't specify location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveRequestInfo":{"properties":{"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to_true, only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"item_types":{"description":"display results by item type
optional field
indicates the type of search results included in the responseitem_types array contains item types that are different from organic, the results will be ordered by the first item type in the array[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
if you use this field, you don’t need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
if you use this field, you don’t need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English","type":["string","null"]},"location_code":{"description":"location code
if you use this field, you don't have to specify location_name
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
if you use this field, you don't have to specify location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"target domains, subdomains, and webpages
required field
you can specify domains, subdomains, and webpages in this field;
domains and subdomains should be specified without https:// and www.;
pages should be specified with absolute URL, including https:// and www.;
you can set up to 1000 domains, subdomains or webpages","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in
example:[\"metrics.organic.pos_1,\">\",0][[[\"metrics.organic.count\",\">=\",100],\"and\",[\"metrics.organic.pos_1\",\">\",0]],
\"or\",
[\"metrics.organic.etv\",\"in\",[10,100]]]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"historical_serp_mode":{"description":"data collection mode
optional field
you can use this field to filter the results;
possible types of filtering:live — return metrics for SERPs in which the specified target currently has ranking results;lost — return metrics for SERPs in which the specified target had previously had ranking results, but didn't have them during the last check;all — return metrics for both types of SERPs.
default value: live","type":["string","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to_true, you will receive clickstream_etv, clickstream_gender_distribution, and_clickstream_age_distribution_fields with clickstream data in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to false, the subcategories will be ignored
default value: false
learn more about the parameter in this help center article","type":["boolean","null"]},"item_types":{"description":"display results by item type
optional field
indicates the type of search results included in the responseitem_types array contains item types that are different from the organic object, the results will be ordered by the first item type in the array; you will not be able to sort and filter results by the types of search results not included in the response;[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of returned categories
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned categories
optional field
default value: 0
if you specify the 10 value, the first ten categories in the results array will be omitted and the data will be provided for the successive categories","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to specify a sorting type
example:[\"metrics.paid.etv,asc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"metrics.organic.etv,desc\",\"metrics.paid.count,asc\"][\"metrics.organic.count,desc\"]
Note: if the item_types array contains item types that are different from the organic object, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain or subdomain
required field
the domain or subdomain name of the target website
the domain or subdomain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000
the keywords will be converted to lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if don't specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/google/categories_for_keywords/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if don't specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/google/categories_for_keywords/languages
example:English","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveRequestInfo":{"properties":{"exclude_domains":{"description":"exclude domains from the results
optional field
use this parameter to exclude specific domains from the results
Note: you can specify up to 1000 domains in this array\"exclude_domains\": [","items":{"type":"string"},"type":["array","null"]},"exclude_top_domains":{"description":"indicates whether to exclude world's largest websites
\"reddit.com\",
\"youtube.com\"
]
optional field
default value: false
set to true if you want to get highly-relevant competitors excluding the websites listed below:wikipedia.org","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
pinterest.com
amazon.com
google.com
facebook.com
wordpress.com
medium.com
quora.com
reddit.com
youtube.com
ebay.com
uol.com.br
instagram.com
olx.com
twitter.com
linkedin.com
slideshare.net
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in
example:[\"metrics.organic.count\",\">\",50][[[\"metrics.organic.count\",\">=\",50],\"and\",[\"metrics.organic.pos_1\",\"in\",[1,5]]],
\"or\",
[\"metrics.organic.etv\",\">=\",\"100\"]]
optional field
if set to_true, only core keywords will be returned, all highly similar keywords will be excluded;
default value: falsen","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to_true, you will receive clickstream_etv, clickstream_gender_distribution, and_clickstream_age_distribution_fields with clickstream data in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
to improve the accuracy of the result, you can specify domains that are known to intersect with the target in SERPs;
if you use this array, metrics in the result will be based on SERPs where both target website and intersecting_domains appear;
Note: you can specify up to 20 domains in this array","items":{"type":"string"},"type":["array","null"]},"item_types":{"description":"display results by item type
optional field
indicates the type of search results included in the responseitem_types array contains item types that are different from organic, the results will be ordered by the first item type in the array; you will not be able to sort and filter results by the types of search results not included in the response;[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of returned domains
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"max_rank_group":{"description":"maximum rank up to which competitors will be considered
optional field
default value: 10010 here, we will extract competitors from the top 10 Google search results only","type":["integer","null"]},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to specify a sorting type
example:[\"metrics.paid.etv,asc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"metrics.organic.etv,desc\",\"metrics.paid.count,asc\"][\"metrics.organic.count,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain
required field
the domain name of the target website
the domain should be specified without https:// and www.
you can specify page URL, but the results will be specific to the domain in the specified URL","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters example: [\"keyword_data.keyword_info.search_volume\",\"in\",[100,1000]] [[\"first_domain_serp_element.etv\",\">\",0],\"and\",[\"first_domain_serp_element.description\",\"like\",\"%goat%\"]] [[\"keyword_data.keyword_info.search_volume\",\">\",100], \"and\", [[\"first_domain_serp_element.description\",\"like\",\"%goat%\"], \"or\", [\"second_domain_serp_element.type\",\"=\",\"organic\"]]] for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result optional field if the parameter is set to true, you will receive clickstream_keyword_info, clickstream_etv, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response default value: false with this parameter enabled, you will be charged double the price for the request learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword optional field if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response default value: false","type":["boolean","null"]},"intersections":{"description":"domain intersections in SERP optional field if you set intersections to true, you will get the keywords for which both target domains specified as target1 and target2 have results within the same SERP; the corresponding SERP elements for both domains will be provided in the results array Note: this endpoint will not provide results if the number of intersecting keywords exceeds 10 million if you specify intersections: false, you will get the keywords for which the domain specified as target1 has results in SERP, and the domain specified as target2 doesn't; thus, the corresponding SERP elements and other data will be provided for the domain specified as target1only default value: true","type":["boolean","null"]},"item_types":{"description":"search results type indicates type of search results included in the response optional field possible values: [\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"] default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code required field if you don't specify language_name Note: it is required to specify either language_name or language_code you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: en","type":["string","null"]},"language_name":{"description":"full name of the language required field if you don't specify language_code Note: it is required to specify either language_name or language_code you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: English","type":["string","null"]},"limit":{"description":"the maximum number of returned keywords optional field default value: 100 maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code required field if you don't specify location_name Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: 2840","type":["integer","null"]},"location_name":{"description":"full name of the location required field if you don't specify location_code Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: United Kingdom","type":["string","null"]},"offset":{"description":"offset in the items array of returned keywords optional field default value: 0 if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc - results will be sorted in the ascending order desc - results will be sorted in the descending order you should use a comma to set up a sorting parameter example: [\"keyword_data.keyword_info.competition,desc\"] default rule: [\"keyword_data.keyword_info.search_volume,desc\"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: [\"keyword_data.keyword_info.search_volume,desc\",\"keyword_data.keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response","type":["string","null"]},"target1":{"description":"domain required field the domain name of the first target website the domain should be specified without https:// and www.","type":"string"},"target2":{"description":"domain required field the domain name of the second target website the domain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveRequestInfo":{"properties":{"category_codes":{"description":"product and service categories
required field
The maximum number of categories you can specify: 5
you can download the full list of possible categories","items":{"type":"string"},"type":"array"},"correlate":{"description":"correlate data with previously obtained datasets
optional field
default value: true;
if you use this parameter, our system will correlate data you obtain now with previously obtained datasets;
this parameter is intended to mitigate any inconsistencies that may result from changes to our database;
Note: we do not recommend setting correlate to false","type":["boolean","null"]},"etv_max":{"description":"maximum current organic ETV of the domain
optional field
if specified, the API will return only domains with organic_etv lesser than the specified value","type":["integer","null"]},"etv_min":{"description":"minimum current organic ETV of the domain
optional field
if specified, the API will return only domains with organic_etv greater than the specified value","type":["integer","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum);
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like;
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters;
example:[\"metrics_history.202110.organic.pos_1\", \">\", 15];
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"first_date":{"description":"first date of comparison period
required field
first date for which domain metrics will be provided;
date format: \"yyyy-mm-dd\";
example: \"2021-06-01\";
the list available dates is available through the available history endpoint;
Note: first_date cannot be greater than today's date;
Also note: the dates specified in first_date and second_date cannot point to the same month of the same year;
you can specify the dates in any order: first_date can be greater than second_date and vice versa;
minimum date: \"2020-10-01\"","type":"string"},"include_subdomains":{"description":"return subdomains in the API response
optional field
if false, the API response will contain main_domain only;
if true, the API will return main_domain plus its subdomains (if available);
default value: true","type":["boolean","null"]},"item_types":{"description":"display results by item type
optional field
indicates the type of search results included in the response;item_types array contains item types that are different from the organic object, the results will be ordered by the first item type in the array; you will not be able to sort and filter results by the types of search results not included in the response;[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"];
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"unique language identifier
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code;
you can receive the list of available languages with their language_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code;
you can receive the list of available languages with their language_name by making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
example:English","type":"string"},"limit":{"description":"the maximum number of domains in the results array
optional field
default value: 100;
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code;
you can receive the list of available locations with their location_code by making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code;
you can receive the list of available locations with their location_name by making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0;
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
default rule: [\"organic_etv,desc\"];
possible sorting types:asc - results will be sorted in ascending orderdesc - results will be sorted in descending order;
you should use a comma to set up a sorting type;
example:[\"organic_count,desc\"];
note that you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"organic_etv,desc\",\"organic_count,asc\"]","items":{"type":"string"},"type":["array","null"]},"second_date":{"description":"second date of comparison period
required field
second date for which domain metrics will be provided;
date format: \"yyyy-mm-dd\";
example: \"2021-10-01\";
the list available dates is available through the available history endpoint;
Note: second_date cannot be greater than today's date;
Also note: the dates specified in first_date and second_date cannot point to the same month of the same year;
you can specify the dates in any order: second_date can be greater than first_date and vice versa;
minimum date: \"2020-10-01\"","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255;
you can use this parameter to identify the task and match it with the result;
you will find the specified tag value in the data object of the response","type":["string","null"]},"top_categories_count":{"description":"number of additional domain categories
optional field
by using this parameter, you can receive domains relevant to additional categories that are not specified in category_codes above;
to learn more about the parameter, please refer to this help center article;
by default, top_categories_count is equal to the number of categories specified in the category_codes array;
Note: top_categories_count cannot be less than the number of categories in the category_codes array;
maximum value: 5","format":"int64","type":["integer","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveRequestInfo":{"properties":{"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to_true, all highly similar keywords will be excluded from the ranking and traffic calculations, the results will be based on data for main keywords from groups of synonyms
default value: falsen","type":["boolean","null"]},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English","type":["string","null"]},"limit":{"description":"the maximum number of returned results for domain
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
optional field
if you use this field, you don't need to specify location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"offset":{"description":"offset in the results array of returned items
optional field
default value: 0
if you specify the 10 value, the first ten items in the results array will be omitted and the data will be provided for the successive items","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain
required field
the domain name of the target website
the domain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the data will be provided for the previous 12 months
minimal possible value: 2020-10-01
date format: \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default;
date format: \"yyyy-mm-dd\"
example:\"2021-04-01\"","type":["string","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to_true only core keywords will be returned, all highly similar keywords will be excluded;
default value: falsen","type":["boolean","null"]},"item_types":{"description":"display results by item type
optional field
indicates the type of search results included in the response;
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array;
possible values:[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value:[\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
if you use this field, you don’t need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
if you use this field, you don’t need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English","type":["string","null"]},"location_code":{"description":"location code
if you use this field, you don't have to specify location_name
you can receive the list of available locations with their location_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
if you use this field, you don't have to specify location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"description":"target domains and subdomains
required field
you can specify domains and subdomains in this field;
domains and subdomains should be specified without https:// and www.;
you can set up to 1000 domains or subdomains","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveRequestInfo":{"properties":{"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 700
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the specified keywords will be converted to lowercase format, data will be provided in a separate array
you will not be charged for the keywords omitted in the resultskeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveRequestInfo":{"properties":{"correlate":{"description":"correlate data with previously obtained datasets
optional field
default value: true
if you use this parameter, our system will correlate data you obtain now with previously obtained datasets
this parameter is intended to mitigate any inconsistencies that may result from changes to our database
we recommend always setting correlate to true","type":["boolean","null"]},"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the data will be provided for the previous 6 months
minimal possible value: 2020-10-01
date format: \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2021-04-01\"","type":["string","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true, only data based on core keywords will be returned, data for all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_etv, clickstream_gender_distribution, and clickstream_age_distribution fields with clickstream data in the response;
default value: false;
with this parameter enabled, you will be charged double the price for the request;
learn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain
required field
the domain name of the target website
the domain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveRequestInfo":{"properties":{"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result\noptional field\nif the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response\ndefault value: false\nwith this parameter enabled, you will be charged double the price for the request\nlearn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword\noptional field\nif set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response\ndefault value: false","type":["boolean","null"]},"keywords":{"description":"keywords\nrequired field\nThe maximum number of keywords you can specify: 700\nThe maximum number of characters for each keyword: 80\nThe maximum number of words for each keyword phrase: 10\nthe specified keywords will be converted to lowercase format, data will be provided in a separate array\nnote that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn’t contain such keywords and cannot return data on them\nyou will not be charged for the keywords omitted in the results\nlearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code\nrequired field if you don’t specify language_name\nNote: it is required to specify either language_name or language_code\nyou can receive the list of available locations with their language_code by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of the language\nrequired field if you don’t specify language_code\nNote: it is required to specify either language_name or language_code\nyou can receive the list of available locations with their language_name by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"location code\nrequired field if you don’t specify location_name\nNote: it is required to specify either location_name or location_code\nyou can receive the list of available locations with their location_code by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of the location\nrequired field if you don’t specify location_code\nNote: it is required to specify either location_name or location_code\nyou can receive the list of available locations with their location_name by making a separate request to the\nhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages\nexample:\nUnited Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the API will return all SERPs collected for 365 days starting from the current datetime value;
minimal possible value: 365 days from the current datetime value;
date format: \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default;
date format: \"yyyy-mm-dd\";
example:\"2021-09-01\"","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field;
all %## will be decoded (plus character ‘+’ will be decoded to a space character);
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”","type":"string"},"language_code":{"description":"unique language identifier
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code parameters by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name parameters by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleKeywordIdeasLiveRequestInfo":{"properties":{"closely_variants":{"description":"search mode
optional field
if set to_true the results will be based on the phrase-match search algorithm
if set to false the results will be based on the broad-match search algorithm
default value: falsen","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
you can use the % operator with like and not_like,as well as ilike, not_ilike to match any string of zero or more characters
note that you can not filter the results by relevance
example:[\"keyword_info.search_volume\",\">\",0][[\"keyword_info.search_volume\",\"in\",[0,1000]],
\"and\",
[\"keyword_info.competition_level\",\"=\",\"LOW\"]][[\"keyword_info.search_volume\",\">\",100],
\"and\",
[[\"keyword_info.cpc\",\"<\",0.5],
\"or\",
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to_true only core keywords will be returned, all highly similar keywords will be excluded;
default value: falsen","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"keywords":{"description":"keywords
required field
UTF-8 encoding
The maximum number of keywords you can specify: 200.
The keywords will be converted to lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en
Note: if omitted, results default to the language with the most keyword records in the specified location;
refer to the available_languages.keywords field of the Locations and Languages endpoint to determine the default language","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English
Note: if omitted, results default to the language with the most keyword records in the specified location;
refer to the available_languages.keywords field of the Locations and Languages endpoint to determine the default language","type":["string","null"]},"limit":{"description":"the maximum number of keywords in the results array
optional field
default value: 700
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task.
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter[\"relevance,desc\"]
relevance is used as the default sorting rule to provide you with the closest keyword ideas. We recommend using this sorting rule to get highly-relevant search terms. Note that relevance is only our internal system identifier, so it can not be used as a filter, and you will not find this field in the result array. The relevance score is based on a similar principle as used in the Keywords For Keywords endpoint.
you should use a comma to separate several sorting rules
example:[\"relevance,desc\",\"keyword_info.search_volume,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveRequestInfo":{"properties":{"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 700
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the specified keywords will be converted to lowercase format, data will be provided in a separate array
you will not be charged for the keywords omitted in the resultskeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleKeywordSuggestionsLiveRequestInfo":{"properties":{"exact_match":{"description":"search for the exact phrase
optional field
if set to true, the returned keywords will include the exact keyword phrase you specified, with potentially other words before or after that phrase
default value: false","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
example:[\"keyword_info.search_volume\",\">\",0][[\"keyword_info.search_volume\",\"in\",[0,1000]],
\"and\",
[\"keyword_info.competition_level\",\"=\",\"LOW\"]][[\"keyword_info.search_volume\",\">\",100],
\"and\",
[[\"keyword_info.cpc\",\"<\",0.5],
\"or\",
[\"keyword_info.high_top_of_page_bid\",\"<=\",0.5]]]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to true, data for the seed keyword specified in the keyword field will be provided in the seed_keyword_data array of the response
default value: false","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
required field
UTF-8 encoding
the keywords will be converted to lowercase format;keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en
Note: if omitted, results default to the language with the most keyword records in the specified location;
refer to the available_languages.keywords field of the Locations and Languages endpoint to determine the default language","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English
Note: if omitted, results default to the language with the most keyword records in the specified location;
refer to the available_languages.keywords field of the Locations and Languages endpoint to determine the default language","type":["string","null"]},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations with their location_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
optional field
if you use this field, you don't need to specify location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task.
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
a comma is used as a separator
example:[\"keyword_info.competition,desc\"]
default rule:[\"keyword_info.search_volume,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveRequestInfo":{"properties":{"app_id":{"description":"id of the apps
required field
ID of the mobile application on Google Play;
you can find the ID in the URL of every app listed on Google Play;
example:
in the URL https://play.google.com/store/apps/details?id=org.telegram.messenger
the id is org.telegram.messenger","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in
example:[\"keyword_data.keyword_info.search_volume\",\">\",500][[\"keyword_data.keyword_info.search_volume\",\"<>\",500],\"and\",[\"ranked_serp_element.serp_item.rank_group\",\">=\",\"10\"]]
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the English language only;
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US location only;
example:United States","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results;
possible sorting types:asc - results will be sorted in the ascending order;desc - results will be sorted in the descending order;
you should use a comma to specify a sorting type;
example:[\"ranked_serp_element.serp_item.rank_group,asc\"]
Note: you can set no more than three sorting rules in a single request;
you should use a comma to separate several sorting rules;
example:[\"ranked_serp_element.serp_item.rank_group,desc\",\"keyword_data.keyword_info.search_volume,asc\"]
default rule:[\"keyword_data.keyword_info.search_volume,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleKeywordsForCategoriesLiveRequestInfo":{"properties":{"category_codes":{"description":"product and service categories
required field
The maximum number of categories you can specify: 20
you can download the full list of possible categories","items":{"type":"string"},"type":"array"},"category_intersection":{"description":"category intersections
optional field
if set to true, you will get keywords featured in all specified categories;
if set to false, you will keywords that are specified in any of the specified categories;
default value: true","type":["boolean","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
you can use the % operator with like and not_like,as well as ilike, not_ilike to match any string of zero or more characters
example:[\"keyword_info.search_volume\",\">\",0][[\"keyword_info.search_volume\",\"in\",[0,1000]],
\"and\",
[\"keyword_info.competition_level\",\"=\",\"LOW\"]][[\"keyword_info.search_volume\",\">\",100],
\"and\",
[[\"keyword_info.cpc\",\"<\",0.5],
\"or\",
[\"keyword_info.high_top_of_page_bid\",\"<=\",0.5]]]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"language_code":{"description":"unique language identifier
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of keywords in the results array
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task.
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"keyword_info.competition,desc\"]
default rule:[\"keyword_info.search_volume,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword_info.search_volume,desc\",\"keyword_info.competition,asc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleKeywordsForSiteLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
note that you can not filter the results by relevance
example:[\"keyword_info.search_volume\",\">\",0]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to_true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en
Note: if omitted, results default to the language with the most keyword records in the specified location;
refer to the available_languages.keywords field of the Locations and Languages endpoint to determine the default language","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English
Note: if omitted, results default to the language with the most keyword records in the specified location;
refer to the available_languages.keywords field of the Locations and Languages endpoint to determine the default language","type":["string","null"]},"limit":{"description":"the maximum number of keywords in the results array
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task.
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting parameter[\"relevance,desc\"]
relevance is used as the default sorting rule to provide you with the closest keyword ideas. We recommend using this sorting rule to get highly-relevant search terms. Note that relevance is only our internal system identifier, so it can not be used as a filter, and you will not find this field in the result array. The relevance score is based on a similar principle as used in the Keywords For Keywords endpoint.note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"relevance,desc\",\"keyword_info.search_volume,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain name or page url
required field
the domain name of the target website, subdomain or URL of the target webpage;
the domain name must be specified without https:// or www.;
the subdomain must be specified without https://;
the webpage URL must be specified with https:// or www.
Note: if you specify the webpage URL without https:// or www., the result will be returned for the entire domain rather than the specific page","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGooglePageIntersectionLiveRequestInfo":{"properties":{"exclude_pages":{"description":"URLs of pages you want to excludeoptional fieldyou can set up to 10 pages in this arrayif you use this array, results will contain the keywords for which URLs from the pages object rank, but URLs from exclude_pages array do not;note that if you specify this field, the results will be based on the keywords any URL from pages ranks for regardless of intersections between them. However, you can set intersection_mode to intersect and results will contain the keywords all URLs from pages rank for in the same SERP and URLs from exclude_pages do not. use a wildcard ('*') character to specify the search patternexample:\"exclude_pages\":[\"https://www.apple.com/iphone/*\",\"https://dataforseo.com/apis/*\",\"https://www.microsoft.com/en-us/industry/services/\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parametersoptional fieldyou can add several filters at once (8 filters maximum)you should set a logical operator and, or between the conditionsthe following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, ilike, not_ilike, like, not_like, match, not_matchyou can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more charactersnote that if you want to filter by any field in the intersection_result array you need to specify the number of corresponding pagefor instance, if you want to filter results by the ranking of the first specified URL, you should set the following filter:[intersection_result.1.rank_absolute,\"=\",1]if you want to filter results and receive only organic listings for the third specified URL, you should set the following filter:[intersection_result.3.type,\"=\",\"organic\"] , etc.example:[\"keyword_data.keyword_info.search_volume\",\"in\",[100,1000]][[\"intersection_result.1.etv\",\">\",0],\"and\",[\"intersection_result.1.description\",\"like\",\"%goat%\"]][[\"keyword_data.keyword_info.search_volume\",\">\",100],\"and\",[[\"intersection_result.2.description\",\"like\",\"%goat%\"],\"or\",[\"intersection_result.2.type\",\"=\",\"organic\"]]]for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywordsoptional fieldif set to true only core keywords will be returned, all highly similar keywords will be excluded; default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the resultoptional fieldif the parameter is set to true, you will receive clickstream_keyword_info, clickstream_etv, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the responsedefault value: falsewith this parameter enabled, you will be charged double the price for the requestlearn more about how clickstream-based metrics are calculated in this help center article","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keywordoptional fieldif set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the responsedefault value: false","type":["boolean","null"]},"include_subdomains":{"description":"indicates if the subdomains will be included in the searchoptional fieldif set to false, the subdomains will be ignoreddefault value: true","type":["boolean","null"]},"intersection_mode":{"description":"indicates whether to intersect keywordsoptional fielduse this field to intersect or merge results for the specified URLspossible values: union, intersectunion - results are based on all keywords any URL from pages rank for;intersect - results are based on the keywords all URLs from pages rank for in the same SERP:by default, results are based on the intersect mode if you specify only pages array. If you specify exclude_pages as well, results are based on the union mode","type":["string","null"]},"item_types":{"description":"search results typeindicates type of search results included in the responseoptional fieldpossible values: [\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language coderequired field if you don't specify language_nameNote: it is required to specify either language_name or language_codeyou can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample:en","type":["string","null"]},"language_name":{"description":"full name of the languagerequired field if you don't specify language_codeNote: it is required to specify either language_name or language_codeyou can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample:English","type":["string","null"]},"limit":{"description":"the maximum number of returned keywordsoptional fielddefault value: 100maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location coderequired field if you don't specify location_nameNote: it is required to specify either location_name or location_codeyou can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample:2840","type":["integer","null"]},"location_name":{"description":"full name of the locationrequired field if you don't specify location_codeNote: it is required to specify either location_name or location_codeyou can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample:United Kingdom","type":["string","null"]},"offset":{"description":"offset in the items array of returned keywordsoptional fielddefault value: 0if you specify 10 here, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rulesoptional fieldyou can use the same values as in the filters array to sort the resultspossible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending orderyou should use a comma to set up a sorting parameterexample:[\"keyword_data.keyword_info.competition,desc\"]default rule:[\"keyword_data.keyword_info.search_volume,desc\"]note that you can set no more than three sorting rules in a single requestyou should use a comma to separate several sorting rulesexample:[\"intersection_result.1.rank_group,asc\",\"intersection_result.2.rank_absolute,asc\"]","items":{"type":"string"},"type":["array","null"]},"pages":{"additionalProperties":{"type":["string","null"]},"description":"target URLs of pagesrequired fieldyou can set up to 20 pages in this objectthe pages should be specified with absolute URLs (including http:// or https://)example:\"pages\": {\"1\":\"https://www.apple.com/mac/*\",\"2\":\"https://dataforseo.com/*\",\"3\":\"https://support.microsoft.com/\"}if you specify a single page here, we will return results only for this page;you can also use a wildcard ('') character to specify the search patternexample:\"example.com\"search for the exact URL\"example.com/eng/\"search for the example.com page and all its related URLs which start with '/eng/', such as \"example.com/eng/index.html\" and \"example.com/eng/help/\", etc.note: a wilcard should be placed after the slash ('/') character in the end of the URL, it is not possible to place it after the domain in the following way:https://dataforseo.comuse https://dataforseo.com/ insteadNote: this endpoint will not provide results if the number of intersecting keywords exceeds 10 million","type":["object","null"]},"tag":{"description":"user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
example:[\"ranked_serp_element.serp_item.rank_group\",\"<=\",10][[\"ranked_serp_element.serp_item.rank_group\",\"<=\",10],
\"and\",
[\"ranked_serp_element.serp_item.type\",\"<>\",\"paid\"]][[\"keyword_data.keyword_info.search_volume\",\"<>\",0],
\"and\",
[[\"ranked_serp_element.serp_item.type\",\"<>\",\"paid\"],\"or\",[\"ranked_serp_element.serp_item.is_malicious\",\"=\",false]]]target field or filter by the ranked_serp_element.serp_item.relative_url parameter
example:[\"ranked_serp_element.serp_item.relative_url\", \"=\", \"/apis/rank-tracker-api\"]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"historical_serp_mode":{"description":"data collection mode
optional field
you can use this field to filter the results;
possible types of filtering:live — return keywords for which the specified target currently has ranking results in SERP;lost — return keywords for which the specified target had previously had ranking results in SERP, but didn't have them during the last check;all — return both types of keywords.
default value: live","type":["string","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_keyword_info, clickstream_etv, clickstream_gender_distribution, clickstream_age_distribution, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
indicates the type of search results included in the responseitem_types array contains item types that are different from organic, the results will be ordered by the first item type in the array; you will not be able to sort and filter results by the types of search results not included in the response;[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\", \"ai_overview_reference\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English","type":["string","null"]},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"load_rank_absolute":{"description":"return rankings distribution by rank_absolute
optional field
default value: false
if set to true, we will return the field metrics_absolute containing rankings distribution by the rank_absolute parameter that indicates the result’s position among all SERP elements","type":["boolean","null"]},"location_code":{"description":"location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
optional field
if you use this field, you don't need to specify location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"keyword_data.keyword_info.competition,desc\"]
default rule:[\"ranked_serp_element.serp_item.rank_group,asc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword_data.keyword_info.search_volume,desc\",\"keyword_data.keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain name or page url
required field
the domain name of the target website, subdomain or URL of the target webpage;
the domain name must be specified without https:// or www.;
the subdomain must be specified without https://;
the webpage URL must be specified with https:// or www.
Note: if you specify the webpage URL without https:// or www., the result will be returned for the entire domain rather than the specific page","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveRequestInfo":{"properties":{"depth":{"description":"keyword search depth
optional field
default value: 1
you can specify a level from 0 to 4
estimated number of keywords for each level (maximum):
0 - the keyword set in the keyword field
1 – 8 keywords
2 – 72 keywords
3 – 584 keywords
4 – 4680 keywords","type":["integer","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like,not_like
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
example:[\"keyword_data.keyword_info.search_volume\",\">\",0][[\"keyword_info.search_volume\",\"in\",[0,1000]],
\"and\",
[\"keyword_data.keyword_info.competition_level\",\"=\",\"LOW\"]][[\"keyword_data.keyword_info.search_volume\",\">\",100],
\"and\",
[[\"keyword_data.keyword_info.cpc\",\"<\",0.5],
\"or\",
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"","type":["boolean","null"]},"include_clickstream_data":{"description":"","type":["boolean","null"]},"include_seed_keyword":{"description":"include data for the seed keyword
optional field
if set to true, data for the seed keyword specified in the keyword field will be provided in the seed_keyword_data array of the response
default value: false","type":["boolean","null"]},"include_serp_info":{"description":"include data from SERP for each keyword
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
required field
UTF-8 encoding
the keywords will be converted to lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"keyword_data.keyword_info.competition,desc\"]
default rule:[\"keyword_data.keyword_info.search_volume,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword_data.keyword_info.search_volume,desc\",\"keyword_data.keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"replace_with_core_keyword":{"description":"return data for core keyword
optional field
if true, serp_info and related_keywords will be returned for the main keyword in the group that the specified keyword belongs to;
if false, serp_info and related_keywords will be returned for the specified keyword (if available);
refer to this help center article for more details;
default value: false","type":["boolean","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in[\"metrics.paid.count\",\">\",0][[\"metrics.organic.count\",\">\",50],\"and\",[\"metrics.organic.pos_1\",\"<>\",0]][[\"\"metrics.organic.count\",\">\",50\"],
\"and\",
[[\"metrics.organic.pos_1\",\"<>\",0],\"or\",[\"metrics.organic.pos_2_3\",\"<>\",0]]]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"historical_serp_mode":{"description":"data collection mode
optional field
you can use this field to filter the results;
possible types of filtering:live — return metrics for SERPs in which the specified target currently has ranking results;lost — return metrics for SERPs in which the specified target had previously had ranking results, but didn't have them during the last check;all — return metrics for both types of SERPs.
default value: live","type":["string","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true, only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_etv, clickstream_gender_distribution, and clickstream_age_distribution fields with clickstream data in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
indicates the type of search results included in the responseitem_types array contains item types that are different from organic, the results will be ordered by the first item type in the array; you will not be able to sort and filter results by the types of search results not included in the response;[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English","type":["string","null"]},"limit":{"description":"the maximum number of returned pages
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
optional field
if you use this field, you don't need to specify location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"offset":{"description":"offset in the results array of returned pages
optional field
default value: 0
if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to specify a sorting type
example:[\"metrics.paid.etv,asc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"metrics.organic.etv,desc\",\"metrics.paid.count,asc\"][\"metrics.organic.count,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain
required field
the domain name of the target website
the domain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleSearchIntentLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000;
the keywords will be converted to lowercase formatkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
you can use the % operator with like and not_like, as well as ilike and not_ilike to match any string of zero or more characters
example:[\"median_position\",\"in\",[1,10]][[\"median_position\",\"in\",[1,10]],\"and\",[\"domain\",\"not_like\",\"%wikipedia.org%\"]][[\"domain\",\"not_like\",\"%wikipedia.org%\"],
\"and\",
[[\"relevant_serp_items\",\">\",0],\"or\",[\"median_position\",\"in\",[1,10]]]]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"include_subdomains":{"description":"indicates if the subdomains will be included in the search
optional field
if set to false, the subdomains will be ignored
default value: true","type":["boolean","null"]},"item_types":{"description":"search results type
indicates type of search results included in the response
optional field[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"keywords":{"description":"keywords array
required field
the results will be based on the keywords you specify in this array
UTF-8 encoding;
the keywords will be converted to lowercase format;
you can specify the maximum of 200 keywordskeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"unique language identifier
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_code parameters by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available languages with their language_name parameters by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of returned domains
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code parameters by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with location_name parameters by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
the comma is used as a separator
example:[\"avg_position,asc\"]
default rule:[\"rating,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"avg_position,asc\",\"etv,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleSubdomainsLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in
example:[\"metrics.paid.count\",\">\",0][[\"metrics.paid.count\",\">\",0],\"and\",[\"metrics.paid.etv\",\">\",\"50\"]][[\"metrics.organic.count\",\">\",\"10\"],
\"and\",
[[\"metrics.organic.pos_1\",\"<>\",0],\"or\",[\"metrics.organic.pos_2_3\",\"<>\",0]]]
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"historical_serp_mode":{"description":"data collection mode
optional field
you can use this field to filter the results;
possible types of filtering:live — return metrics for SERPs in which the specified target currently has ranking results;lost — return metrics for SERPs in which the specified target had previously had ranking results, but didn't have them during the last check;all — return metrics for both types of SERPs.
default value: live","type":["string","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true, only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_etv, clickstream_gender_distribution, and clickstream_age_distribution fields with clickstream data in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
indicates the type of search results included in the responseitem_types array contains item types that are different from organic, the results will be ordered by the first item type in the array; you will not be able to sort and filter results by the types of search results not included in the response;[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
default value: [\"organic\", \"paid\"]","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"language code
optional field
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
optional field
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available languages
example:English","type":["string","null"]},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:2840","type":["integer","null"]},"location_name":{"description":"full name of the location
optional field
if you use this field, you don't need to specify location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore this field to get the results for all available locations
example:United Kingdom","type":["string","null"]},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to specify a sorting type
example:[\"metrics.paid.etv,asc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"metrics.organic.etv,desc\",\"metrics.paid.count,asc\"][\"metrics.organic.count,desc\"]
Note: if the item_types array contains item types that are different from organic, the results will be ordered by the first item type in the array","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain
required field
the domain name of the target website
the domain should be specified without https:// and www.","type":"string"}},"type":"object"},"Provider0A3E90081762_DataforseoLabsGoogleTopSearchesLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like,not_like
you can use the % operator with like and not_like,as well as ilike and not_ilike to match any string of zero or more characters
example:[\"keyword_info.search_volume\",\">\",0][[\"keyword_info.search_volume\",\"in\",[0,1000]],
\"and\",
[\"keyword_info.competition_level\",\"=\",\"LOW\"]][[\"keyword_info.search_volume\",\">\",100],
\"and\",
[[\"keyword_info.cpc\",\"<\",0.5],
\"or\",
for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"ignore_synonyms":{"description":"ignore highly similar keywords
optional field
if set to true only core keywords will be returned, all highly similar keywords will be excluded;
default value: false","type":["boolean","null"]},"include_clickstream_data":{"description":"include or exclude data from clickstream-based metrics in the result
optional field
if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response
default value: false
with this parameter enabled, you will be charged double the price for the request
optional field
if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response
default value: false","type":["boolean","null"]},"language_code":{"description":"language code
required field if you don't specify language_name
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en","type":["string","null"]},"language_name":{"description":"full name of the language
required field if you don't specify language_code
Note: it is required to specify either language_name or language_code
you can receive the list of available locations with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English","type":"string"},"limit":{"description":"the maximum number of returned keywords
optional fieldoffset_token provided in the response to each subsequent request
default value: 1000
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:United Kingdom","type":"string"},"offset":{"description":"offset in the results array of returned keywords
optional field
default value: 0
if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use the offset_token instead.","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task.
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"keyword_info.competition,desc\"]
default rule:[\"keyword_info.search_volume,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveRequestInfo":{"properties":{"category":{"description":"id of the target technology category
required field if you don't specify group, keyword or technology
at least one field (group, category, keyword, technology) must be set
you can find the full list of technology category ids on this page
example:\"crm\"","type":"string"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in, like,not_like
you can use the % operator with like and not_like to match any string of zero or more characters
you can use the following parameters to filter the results: domain_rank, last_visited, country_iso_code, language_code, content_language_code
Note: all filtering parameters are taken from the domain_technology_item of the domain_technologies endpoint;
example:[[\"country_iso_code\",\"=\",\"US\"],for more information about filters, please refer to Domain Analytics Technologies API - Filters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"group":{"description":"id of the target technology group
\"and\",
[\"domain_rank\",\">\",800]]
required field if you don't specify technology, category or keyword
at least one field (group, category, keyword, technology) must be set
you can find the full list of technology group ids on this page
example:\"marketing\"","type":"string"},"internal_categories_list_limit":{"description":"maximum number of returned technology categories within the same group
optional field
you can use this field to limit the number of items with identical \"category\" in the results
default value: 5
minimum value: 1
maximum value: 10000","type":["integer","null"]},"internal_groups_list_limit":{"description":"maximum number of returned technology groups
optional field
you can use this field to limit the number of items with identical \"group\" in the results
default value: 5
minimum value: 1
maximum value: 10000","type":["integer","null"]},"internal_list_limit":{"description":"maximum number of items with identical \"category\", \"group\", and \"technology\"
optional field
if you use this field, the values specified in internal_groups_list_limit, internal_categories_list_limit and internal_technologies_list_limit will be ignored;
you can use this field to limit the number of items with identical \"category\", \"group\", or \"technology\"
default value: 10
minimum value: 1
maximum value: 10000","type":["integer","null"]},"internal_technologies_list_limit":{"description":"maximum number of returned technologies within the same category
optional field
you can use this field to limit the number of items with identical \"technology\" in the results
default value: 10
minimum value: 1
maximum value: 10000","type":["integer","null"]},"keyword":{"description":"target keyword in the domain's meta keywords
required field if you don't specify group, category or technology
at least one field (group, category, keyword, technology) must be set
UTF-8 encoding
example:\"seo\"learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"limit":{"description":"the maximum number of returned technologies
optional field
default value: 100
maximum value: 10000","type":["integer","null"]},"mode":{"description":"search mode
optional field
possible search mode types:as_is - search for results exactly matching the specified group ids, category ids, or technology namesentry - search for results matching a part of the specified group ids, category ids, or technology names
default value: as_is","type":["string","null"]},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
maximum value: 9999
if you specify the 10 value, the first ten technologies in the results array will be omitted and the data will be provided for the successive technologies","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the following values to sort the results: groups_count, categories_count, technologies_count
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"groups_count,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"groups_count,desc\",\"technologies_count,desc\"]
default value:[\"groups_count,desc\",\"categories_count,desc\",\"technologies_count,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"technology":{"description":"target technology
required field if you don't specify group, keyword or category
at least one field (group, category, keyword, technology) must be set
you can find the full list of technologies on this page
example:\"Salesforce\"","type":"string"}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsTechnologiesDomainTechnologiesLiveRequestInfo":{"properties":{"target":{"description":"target domain
required field
domain name of the website to analyze
Note: results will be returned for the specified domain only","type":"string"}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"domain\",\"like\",\"%seo%\"][[\"country_iso_code\",\"=\",\"US\"],
\"and\",
[\"domain_rank\",\">\",100]][[\"domain_rank\",\">\",100],
\"and\",
[[\"country_iso_code\",\"=\",\"US\"],\"or\",[\"country_iso_code\",\"=\",\"CA\"]]]
optional field
UTF-8 encoding
maximum number of keywords you can specify: 10
example:[\"seo\",\"software\"]keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":["array","null"]},"limit":{"description":"the maximum number of returned domains
optional field
default value: 100
maximum value: 10000","type":["integer","null"]},"mode":{"description":"search mode
optional field
possible search mode types:strict_entry - search for results exactly matching the order, intervals and separators in the specified search termsentry - search for results ignoring the order, intervals and separators in the specified search terms
default value: entry","type":["string","null"]},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains;
Note: the maximum value is 9999, the sum of limit and offset must not exceed 10000;
use the offset_token if you would like to offset more results","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
available fields: domain_rank, domain, last_visited, country_iso_code, language_code, content_language_code
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"last_visited,desc\"]
default rule:[\"domain_rank,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"last_visited,desc\",\"domain_rank,desc\"]","items":{"type":"string"},"type":["array","null"]},"search_terms":{"description":"target search terms
required field
specify target HTML elements, tags, attributes, their content or all of the above
if you specify more than one search term, you will receive only the domains containing all of the specified terms in the HTML code of their homepage
maximum number of search terms you can specify: 10
example:[\"data-attrid\"]","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsTechnologiesDomainsByTechnologyLiveRequestInfo":{"properties":{"categories":{"description":"ids of the target technology categories
required field if you don't specify groups, technology_paths, keywords or technologies
you can find the full list of technology category ids on this page
note: you can specify up to 10 technology categories in this array
example:[\"payment_processors\",\"crm\"]","items":{"type":"string"},"type":"array"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"country_iso_code\",\"=\",\"US\"][[\"country_iso_code\",\"=\",\"US\"],
\"and\",
[\"domain_rank\",\">\",100]][[\"domain_rank\",\">\",100],
\"and\",
[[\"country_iso_code\",\"=\",\"US\"],\"or\",[\"country_iso_code\",\"=\",\"CA\"]]]
required field if you don't specify technologies, technology_paths, keywords or categories
you can find the full list of technology group ids on this page
note: you can specify up to 10 technology groups in this array
example:[\"sales\", \"marketing\"]","items":{"type":"string"},"type":"array"},"keywords":{"description":"target keywords in the domain's title, description or meta keywords
required field if you don't specify groups, technology_paths, technologies or categories
optional field
you can specify the maximum of 10 keywords;
UTF-8 encoding;
example:[\"seo\",\"software\"]keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"limit":{"description":"the maximum number of returned domains
optional field
default value: 100
maximum value: 10000","type":["integer","null"]},"mode":{"description":"search mode
optional field
possible search mode types:as_is - search for results exactly matching the specified group ids, category ids, or technology namesentry - search for results matching a part of the specified group ids, category ids, or technology names
default value: as_is","type":["string","null"]},"offset":{"description":"offset in the results array of returned domains
optional field
default value: 0
if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains;
Note: the maximum value is 9999, the sum of limit and offset must not exceed 10000;
use the offset_token if you would like to offset more results","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
available fields: domain_rank, domain, last_visited, country_iso_code, language_code, content_language_code
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"last_visited,desc\"]
default rule:[\"domain_rank,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"last_visited,desc\",\"domain_rank,desc\"]","items":{"type":"string"},"type":["array","null"]},"technologies":{"description":"target technologies
required field if you don't specify groups, technology_paths, keywords or categories
you can find the full list of technologies you can specify here on this page
note: you can specify up to 10 technologies in this array
example:[\"Google Pay\",\"Salesforce\"]","items":{"type":"string"},"type":"array"},"technology_paths":{"description":"target technology paths
required field if you don't specify groups, technologies, keywords or categories
at least one field (technology_paths, groups, technologies, keywords or categories) must be set;
each technology path should be specified as a separate object containing \"path\" and \"name\", where \"path\" is specified as \"$group_id.$category_id\" and \"name\" - as the name of the target technology;
each object with a technology path should be separated with a comma
you can find the full list of technology group ids, category ids and technology names on this page
note: you can specify up to 10 technology paths in this array
example:[{\"path\": \"content.cms\",\"name\": \"wordpress\"}, {\"path\": \"marketing.crm\",\"name\": \"salesforce\"}]","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsTechnologiesTechnologiesSummaryLiveRequestInfo":{"properties":{"categories":{"description":"ids of the target technology categories
required field if you don't specify groups, technology_paths, technologies, or keywords
you can find the full list of technology category ids on this page
note: you can specify up to 10 technology categories in this array
example:[\"payment_processors\",\"crm\"]","items":{"type":"string"},"type":"array"},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:<, <=, >, >=, =, <>, in, not_in, like,not_like
you can use the % operator with like and not_like to match any string of zero or more characters
you can use the following parameters to filter the results: domain_rank, last_visited, country_iso_code, language_code, content_language_code
example:[[\"country_iso_code\",\"=\",\"US\"],
\"and\",
[\"domain_rank\",\">\",800]]
required field if you don't specify technologies, technology_paths, categories, or keywords
you can find the full list of technology group ids on this page
note: you can specify up to 10 technology groups in this array
example:[\"sales\", \"marketing\"]","items":{"type":"string"},"type":"array"},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:countries, languages, content_languages, keywords
default value: 10
minimum value: 1
maximum value: 10000","type":["integer","null"]},"keywords":{"description":"target keywords in the domain's title, description or meta keywords
required field if you don't specify groups, technology_paths, categories, or technologies
you can specify the maximum of 10 keywords;
UTF-8 encoding;
example:[\"seo\",\"software\"]keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"mode":{"description":"search mode
optional field
possible search mode types:as_is - search for results exactly matching the specified group ids, category ids, or technology namesentry - search for results matching a part of the specified group ids, category ids, or technology names
default value: as_is","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"technologies":{"description":"target technologies
required field if you don't specify groups, technology_paths, categories, or keywords
you can find the full list of technologies you can specify here on this page
note: you can specify up to 10 technologies in this array
example:[\"Google Pay\",\"Salesforce\"]","items":{"type":"string"},"type":"array"},"technology_paths":{"description":"target technology paths
required field if you don't specify groups, technologies and categories
each technology path should be specified as a separate object containing \"path\" and \"name\", where \"path\" is specified as \"$group_id.$category_id\" and \"name\" - as the name of the target technology;
each object with a technology path should be separated with a comma
you can find the full list of technology group ids, category ids and technology names on this page
note: you can specify up to 10 technology paths in this array
example:[{\"path\": \"content.cms\",\"name\": \"wordpress\"}, {\"path\": \"marketing.crm\",\"name\": \"salesforce\"}]","items":{"type":"string"},"type":"array"}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimum value: 2022-10-31
if you don't specify this field, the minimum value will be used by default
date format: \"yyyy-mm-dd\"
example:\"2023-06-01\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2023-01-15\"","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"technology":{"description":"target technology
required field
you can find the full list of technologies you can specify here on this page
example:\"Salesforce\"","type":"string"}},"type":"object"},"Provider0A3E90081762_DomainAnalyticsWhoisOverviewLiveRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"limit":{"description":"the maximum number of returned domains
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned items
optional field
default value: 0
if you specify the 10 value, the first ten items in the results array will be omitted and the data will be provided for the successive items;
Note: we recommend using this parameter only when retrieving up to 10,000 results for retrieving over 10,000 results, use the offset_token instead","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center","type":["string","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
the comma is used as a separator
example:[\"metrics.organic.pos_1,desc\"]
default rule:[\"metrics.organic.count,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"expiration_datetime,asc\",\"metrics.organic.etv,desc\",\"metrics.organic.pos_1,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingAudienceEstimationLiveRequestInfo":{"properties":{"age":{"description":"selection of age ranges for targeting
possible values: eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve","items":{"type":"string"},"type":["array","null"]},"bid":{"description":"desired bid setting value in USD
maximum value: 1000","type":["number","null"]},"daily_budget":{"description":"daily campaign budget value in USD
maximum value: 10000","type":["number","null"]},"gender":{"description":"gender to target
possible values: male, female, unknown","items":{"type":"string"},"type":["array","null"]},"industry":{"description":"industry of LinkedIn profile targeting806301758","items":{"type":"string"},"type":["array","null"]},"job_function":{"description":"job function of LinkedIn profile targeting806300451","items":{"type":"string"},"type":["array","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius (in km)\" format
the data will be provided for the country the specified coordinates belong to
example:29.6821525,-82.4098881,100","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingAudienceEstimationTaskPostRequestInfo":{"properties":{"age":{"description":"selection of age ranges for targeting
possible values: eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve","items":{"type":"string"},"type":["array","null"]},"bid":{"description":"desired bid setting value in USD
maximum value: 1000","type":["number","null"]},"daily_budget":{"description":"daily campaign budget value in USD
maximum value: 10000","type":["number","null"]},"gender":{"description":"gender to target
possible values: male, female, unknown","items":{"type":"string"},"type":["array","null"]},"industry":{"description":"industry of LinkedIn profile targeting806301758","items":{"type":"string"},"type":["array","null"]},"job_function":{"description":"job function of LinkedIn profile targeting806300451","items":{"type":"string"},"type":["array","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius (in km)\" format
the data will be provided for the country the specified coordinates belong to
example:29.6821525,-82.4098881,100","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingKeywordPerformanceLiveRequestInfo":{"properties":{"device":{"description":"device type
optional field
specify this field if you want to get the data for a particular device typepossible values: desktop, mobile, tablet, all
default value: all","type":["string","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the specified keywords will be converted to lowercase, data will be provided in a separate arraykeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:\"en\"","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:\"United States\"","type":"string"},"match":{"description":"keywords match type
optional field
can take the following values:aggregate returns data across all match types;broad returns data for all user queries containing the specified keyword with varying word order;phrase returns data for all user queries containing the specified keyword with identical word order;exact returns data for user query that matches the specified keyword;Note: the aggregate match type is applied by default","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingKeywordPerformanceTaskPostRequestInfo":{"properties":{"device":{"description":"device type
optional field
specify this field if you want to get the data for a particular device typepossible values: desktop, mobile, tablet, all
default value: all","type":["string","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the specified keywords will be converted to lowercase, data will be provided in a separate arraykeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:\"en\"","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations and languages by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
example:\"United States\"","type":"string"},"match":{"description":"keywords match type
optional field
can take the following values:aggregate returns data across all match types;broad returns data for all user queries containing the specified keyword with varying word order;phrase returns data for all user queries containing the specified keyword with identical word order;exact returns data for user query that matches the specified keyword;Note: the aggregate match type is applied by default","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingKeywordsForKeywordsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimal value: 24 months from today's date;
if you don't specify this field, data will be provided for the last 12 months;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"
optional field
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
maximum value: one month from today's date;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"
optional field
specify this field if you want to get the data for a particular device type;
possible values: all, mobile, desktop, tablet
default value: all","type":["string","null"]},"keywords":{"description":"keywords
required field
you can specify the maximum of 200 keywords with each keyword containing no more than 100 characters;
the specified keywords will be converted to lowercase, data will be provided in a separate arraykeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"keywords_negative":{"description":"keywords negative array
optional field
These keywords will be ignored in the results array;
You can specify a maximum of 200 terms that you want to exclude from the results;
the specified keywords will be converted to lowercase format","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
supported languages:en, fr, de","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
supported languages:English, French, German","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"},"search_partners":{"description":"Bing search partners type
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.
default value: false - results are returned for Bing, AOL, and Yahoo search networks","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by search_volume, cpc, competition or relevance in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimal value: 24 months from today's date;
if you don't specify this field, data will be provided for the last 12 months;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"
optional field
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
maximum value: one month from today's date;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"
optional field
specify this field if you want to get the data for a particular device type;
possible values: all, mobile, desktop, tablet
default value: all","type":["string","null"]},"keywords":{"description":"keywords
required field
you can specify the maximum of 200 keywords with each keyword containing no more than 100 characters;
the specified keywords will be converted to lowercase, data will be provided in a separate arraykeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"keywords_negative":{"description":"keywords negative array
optional field
These keywords will be ignored in the results array;
You can specify a maximum of 200 terms that you want to exclude from the results;
the specified keywords will be converted to lowercase format","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
supported languages:en, fr, de","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
supported languages:English, French, German","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.
default value: false - results are returned for Bing, AOL, and Yahoo search networks","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by search_volume, cpc, competition or relevance in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingKeywordsForSiteLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimal value: 24 months from today's date;
if you don't specify this field, data will be provided for the last 12 months;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"
optional field
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
maximum value: one month from today's date;
note: we do not recommend using a custom time range for the past year's dates;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"
optional field
specify this field if you want to get the data for a particular device typepossible values: all, mobile, desktop, tablet
default value: all","type":["string","null"]},"keywords_negative":{"description":"keywords negative array
optional field
These keywords will be ignored in the results array;
You can specify a maximum of 200 terms that you want to exclude from the results;
the specified keywords will be converted to lowercase format","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
supported languages:en, fr, de","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
supported languages:English, French, German","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"},"search_partners":{"description":"Bing search partners type
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.
default value: false - results are returned for Bing, AOL, and Yahoo search networks","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by search_volume, cpc, competition or relevance in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain or URL
required field
the domain name or URL of the target website","type":"string"}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingKeywordsForSiteTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimal value: 24 months from today's date;
if you don't specify this field, data will be provided for the last 12 months;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"
optional field
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
maximum value: one month from today's date;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"
optional field
specify this field if you want to get the data for a particular device type
possible values: all, mobile, desktop, tablet
default value: all","type":["string","null"]},"keywords_negative":{"description":"keywords negative array
optional field
These keywords will be ignored in the results array;
You can specify a maximum of 200 terms that you want to exclude from the results;
the specified keywords will be converted to lowercase format","items":{"type":"string"},"type":["array","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
supported languages:en, fr, de","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
supported languages:English, French, German","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.
default value: false - results are returned for Bing, AOL, and Yahoo search networks","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by search_volume, cpc, competition or relevance in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain or URL
required field
the URL of the webpage or the domain to scan for possible keywords","type":"string"}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingSearchVolumeHistoryLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimum value: 24 months back from today’s date;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;\"yyyy-mm-dd\"
example:\"2020-01-01\"Note: we do not recommend using a custom time range;date_from and date_to parameters are not specified, the data will be returned for the past 24 months;period parameter:weekly, you will get results for the past 15 weeks;
with value daily, you will get results for the past 45 days","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional fieldminimum value: two years back from today’s date;
maximum value: one day from today's date;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"date_from and date_to parameters are not specified, the data will be returned for the past 24 monthsperiod parameter:weekly, you will get results for the past 15 weeks
with value daily, you will get results for the past 45 days","type":["string","null"]},"device":{"description":"device types
optional field
specify this field if you want to get the data for a particular device types
possible values: mobile, desktop, tablet, non_smartphones
default value: [\"mobile\", \"desktop\", \"tablet\", \"non_smartphones\"]","items":{"type":"string"},"type":["array","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 100
the specified keywords will be converted to lowercase, data will be provided in a separate arraylearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engines with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/search_volume_history/locations_and_languages","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engines with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/search_volume_history/locations_and_languages","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/search_volume_history/locations_and_languages
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/search_volume_history/locations_and_languages
example:London,England,United Kingdom","type":"string"},"period":{"description":"aggregates the returned data to a certain time period
optional field
specify this field if you want to get the data in monthly, weekly or daily formatpossible values: monthly, weekly, dailymonthly - returns data up to past 24 monthsweekly - returns data up to past 15 weeksdaily - returns data up to past 45 daysmonthly","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimum value: two years back from today’s date
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"date_from and date_to parameters are not specified, the data will be returned for the past 24 monthsperiod parameter:weekly, you will get results for the past 15 weeks
with value daily, you will get results for the past 45 days","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
maximum value: one day from today's date;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"date_from and date_to parameters are not specified, the data will be returned for the past 24 monthsperiod parameter:weekly, you will get results for the past 15 weeks
with value daily, you will get results for the past 45 days","type":["string","null"]},"device":{"description":"device types
optional field
specify this field if you want to get the data for a particular device types
possible values: mobile, desktop, tablet, non_smartphones
default value: [\"mobile\", \"desktop\", \"tablet\", \"non_smartphones\"]","items":{"type":"string"},"type":["array","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 100
the specified keywords will be converted to lowercase, data will be provided in a separate arraykeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"type":["string","null"]},"language_name":{"type":["string","null"]},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/search_volume_history/locations_and_languages
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/search_volume_history/locations_and_languages
example:London,England,United Kingdom","type":"string"},"period":{"description":"aggregates the returned data to a certain time period
optional field
specify this field if you want to get the data in monthly, weekly or daily formatmonthly, weekly, dailymonthly - returns data up to past 24 monthsweekly - returns data up to past 15 weeksdaily - returns data up to past 45 daysmonthly","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingSearchVolumeLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
minimal value: 24 months from today's date;
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
maximum value: one month from today's date;
note: we do not recommend using a custom time range for the past year's dates;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"Note: we do not recommend using a custom time range for the past year's dates","type":["string","null"]},"device":{"description":"device type
optional field
specify this field if you want to get the data for a particular device type;
possible values: all, mobile, desktop, tablet
default value: all","type":["string","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 100
the specified keywords will be converted to lowercase, data will be provided in a separate arraylearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
supported languages:en, fr, de","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
supported languages:English, French, German","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"},"search_partners":{"description":"Bing search partners type
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.
default value: false - results are returned for Bing, AOL, and Yahoo search networks","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by search_volume, cpc, competition or relevance in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataBingSearchVolumeTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, data will be provided for the last 12 months
minimal value: 24 months from today's date
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior;
date format: \"yyyy-mm-dd\"
example:\"2020-01-01\"
optional field
if you don't specify this field, data will be provided for the last 12 months;
minimum value: two years back from today’s date;
maximum value: one month from today's date;
note: we do not recommend using a custom time range for the past year's dates;
date format: \"yyyy-mm-dd\"
example:\"2020-03-15\"
optional field
specify this field if you want to get the data for a particular device typepossible values: all, mobile, desktop, tablet
default value: all","type":["string","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 100
the specified keywords will be converted to lowercase, data will be provided in a separate arraykeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
supported languages:en, fr, de","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
supported languages:English, French, German","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format
the data will be provided for the country the specified coordinates belong to
example:52.6178549,-155.352142","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.
default value: false - results are returned for Bing, AOL, and Yahoo search networks","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by search_volume, cpc, competition or relevance in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataClickstreamDataBulkSearchVolumeLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000;
each keyword should be at least 3 characters long;
the keywords will be converted to lowercase format;
Note: certain symbols and characters (e.g., UTF symbols, emojis) are not allowed
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"location_code":{"description":"location code
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000
the keywords will be converted to lowercase format
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
required field if don’t specify language_name
you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if don’t specify language_code
you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don’t specify location_name
if you use this field, you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
example:2826","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don’t specify location_code
you can receive the list of available locations with location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"use_clickstream":{"description":"use clickstream data to provide results
optional field
if set to true, you will get DataForSEO search volume values based on clickstream data;
if set to false, Bing search volume data will be used to calculate DataForSEO search volume;
default value: true;
Note: Bing search volume is available for locations provided in Bing Search Volume History Locations and Bing Ads Locations endpoints; search volume values for any other location are calculated based on clickstream data even if you set this parameter to false","type":["boolean","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveRequestInfo":{"properties":{"keywords":{"description":"target keywords
required field
UTF-8 encoding
maximum number of keywords you can specify in this array: 1000;
each keyword should be at least 3 characters long;
the keywords will be converted to lowercase format;
Note: certain symbols and characters (e.g., UTF symbols, emojis) are not allowed
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataDataforseoTrendsDemographyLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the current day and month of the preceding year will be used by default
minimal value for the web type: 2004-01-01
minimal value for other types: 2008-01-01
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"keywords":{"description":"keywords
required field
the maximum number of keywords you can specify: 5
avoid symbols and special characters (e.g., UTF symbols, emojis);
specifying non-Latin characters, you’ll get data for the countries where they are usedkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"location_code":{"description":"search engine location code
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_code belongs to;
example:2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_name belongs to;
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"time_range":{"description":"preset time ranges
optional field
if you specify date_from or date_to parameters, this field will be ignored when setting a task
possible values for all type parameters:past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataDataforseoTrendsExploreLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the current day and month of the preceding year will be used by default
minimal value for the web type: 2004-01-01
minimal value for other types: 2008-01-01
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"keywords":{"description":"keywords
required field
the maximum number of keywords you can specify: 5keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"location_code":{"description":"search engine location code
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_code belongs to;
example:2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_name belongs to;
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"time_range":{"description":"preset time ranges
optional field
if you specify date_from or date_to parameters, this field will be ignored when setting a task
possible values for all type parameters:past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataDataforseoTrendsMergedDataLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the current day and month of the preceding year will be used by default
minimal value for the web type: 2004-01-01
minimal value for other types: 2008-01-01
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"keywords":{"description":"keywords
required field
the maximum number of keywords you can specify: 5
avoid symbols and special characters (e.g., UTF symbols, emojis);
specifying non-Latin characters, you’ll get data for the countries where they are usedkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"location_code":{"description":"search engine location code
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_code belongs to;
example:2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_name belongs to;
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"time_range":{"description":"preset time ranges
optional field
if you specify date_from or date_to parameters, this field will be ignored when setting a task
possible values for all type parameters:past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataDataforseoTrendsSubregionInterestsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the current day and month of the preceding year will be used by default
minimal value for the web type: 2004-01-01
minimal value for other types: 2008-01-01
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"keywords":{"description":"keywords
required field
the maximum number of keywords you can specify: 5
avoid symbols and special characters (e.g., UTF symbols, emojis);
specifying non-Latin characters, you’ll get data for the countries where they are usedkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"location_code":{"description":"search engine location code
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_code belongs to;
example:2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
note that the data will be provided for the country the specified location_name belongs to;
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"time_range":{"description":"preset time ranges
optional field
if you specify date_from or date_to parameters, this field will be ignored when setting a task
possible values for all type parameters:past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsLiveRequestInfo":{"properties":{"bid":{"description":"the maximum custom bid
required field
the collected data will be based on this value
it stands for the price you are willing to pay for an ad; the higher value you specify here, the higher values you will get in the returned metrics
learn more in this help center article","format":"int64","type":"integer"},"date_from":{"description":"starting date of the forecasting time range
required field if you specify date_to
if you indicate date_from and date_to, you don't need to specify date_interval
minimum value is tomorrow's date
the value you specify in date_from shouldn't be further than date_to
date format: \"yyyy-mm-dd\"
example:\"2021-10-30\"if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":"string"},"date_interval":{"description":"forecasting date interval
optional field
if you specify date_interval, you don't need to indicate date_from and date_to
possible values: next_week, next_month, next_quarter
default value: next_month","type":["string","null"]},"date_to":{"description":"ending date of the forecasting time range
required field if you specify date_from
if you indicate date_from and date_to, you don't need to specify date_interval
minimum value is date_from +1 day
maximum value is current day and month of the next year
date format: \"yyyy-mm-dd\"
example:\"2022-10-30\"","type":"string"},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the keywords you specify will be converted to a lowercase format
Note: Google Ads may return no data for certain groups of keywords
visit our Help Center to learn more
Also note that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"match":{"description":"keywords match-type
required field
can take the following values: exact, broad, phrase","type":"string"},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by relevance, impressions, ctr, average_cpc, cost, or clicks in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostRequestInfo":{"properties":{"bid":{"description":"the maximum custom bid
required field
the collected data will be based on this value
it stands for the price you are willing to pay for an ad; the higher value you specify here, the higher values you will get in the returned metrics
learn more in this help center article","type":"number"},"date_from":{"description":"starting date of the forecasting time range
required field if you specify date_to
if you indicate date_from and date_to, you don't need to specify date_interval
minimum value is tomorrow's date
the value you specify in date_from shouldn't be further than date_to
date format: \"yyyy-mm-dd\"
example:\"2021-10-30\"if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":"string"},"date_interval":{"description":"forecasting date interval
optional field
if you specify date_interval, you don't need to indicate date_from and date_to
possible values: next_week, next_month, next_quarter
default value: next_month","type":["string","null"]},"date_to":{"description":"ending date of the forecasting time range
required field if you specify date_from
if you indicate date_from and date_to, you don't need to specify date_interval
minimum value is date_from +1 day
maximum value is current day and month of the next year
date format: \"yyyy-mm-dd\"
example:\"2022-10-30\"","type":"string"},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the keywords you specify will be converted to a lowercase format
Note #1: Google Ads may return no data for certain groups of keywords;
Note #2: Google Ads provides combined search volume values for groups of similar keywords
to obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;
Note #3: Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"match":{"description":"keywords match-type
required field
can take the following values: exact, broad, phrase","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
Use these parameters to sort the results by relevance, average_cpc, cost, or clicks in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
date format: \"yyyy-mm-dd\"
minimal value: 4 years from the current date
by default, data is returned for the past 12 months;
Note: the indicated date cannot be greater than that specified in date_to and/or yesterday's date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
Note: the indicated date cannot be greater than yesterday's date;
if you don't specify this field, yesterday's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2022-11-30\"","type":["string","null"]},"include_adult_keywords":{"description":"include keywords associated with adult content
optional field
if set to true, adult keywords will be included in the response
default value: false
note that the API may return no data for such keywords due to Google Ads restrictions","type":["boolean","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 20
The maximum number of characters for each keyword: 80
the keywords you specify will be converted to a lowercase format
Note: Google Ads may return no data for certain groups of keywords
visit our Help Center to learn more
Also note that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"search_partners":{"description":"include Google search partners
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search;
default value: false - results are returned for Google search sites","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
date format: \"yyyy-mm-dd\"
minimal value: 4 years from the current date
by default, data is returned for the past 12 months;
Note: the indicated date cannot be greater than that specified in date_to and/or yesterday's date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
Note: the indicated date cannot be greater than yesterday's date;
if you don't specify this field, yesterday's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2022-11-30\"","type":["string","null"]},"include_adult_keywords":{"description":"include keywords associated with adult content
optional field
if set to true, adult keywords will be included in the response
default value: false
note that the API may return no data for such keywords due to Google Ads restrictions","type":["boolean","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 20
The maximum number of characters for each keyword: 80
the keywords you specify will be converted to a lowercase format
Note: Google Ads may return no data for certain groups of keywords
visit our Help Center to learn more
Also note that Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search;
default value: false - results are returned for Google search sites","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"target website
optional field
specify a website or URL to get a list of keywords relevant to it;
Note: if a website url is specified, you will still get keywords relevant for the entire website","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
date format: \"yyyy-mm-dd\"
minimal value: 4 years from the current date
by default, data is returned for the past 12 months;
Note: the indicated date cannot be greater than that specified in date_to and/or yesterday's date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
Note: the indicated date cannot be greater than yesterday's date;
if you don't specify this field, yesterday's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2022-11-30\"","type":["string","null"]},"include_adult_keywords":{"description":"include keywords associated with adult content
optional field
if set to true, adult keywords will be included in the response
default value: false
note that the API may return no data for such keywords due to Google Ads restrictions","type":["boolean","null"]},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"search_partners":{"description":"include Google search partners
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search;
default value: false - results are returned for Google search sites","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain or page
required field
the domain name of the target website or the url of the target page;
note: to obtain keywords for the target website, use the target_type parameter","type":"string"},"target_type":{"description":"search keywords for site or for url
optional field
possible values: site, page;
default value: page;
if set to site, keywords will be provided for the entire site;
if set to page, keywords will be provided for the specified webpage","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
date format: \"yyyy-mm-dd\"
minimal value: 4 years from the current date
by default, data is returned for the past 12 months;
Note: the indicated date cannot be greater than that specified in date_to and/or yesterday's date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
Note: the indicated date cannot be greater than yesterday's date;
if you don't specify this field, yesterday's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2022-11-30\"","type":["string","null"]},"include_adult_keywords":{"description":"include keywords associated with adult content
optional field
if set to true, adult keywords will be included in the response
default value: false
note that the API may return no data for such keywords due to Google Ads restrictions","type":["boolean","null"]},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search;
default value: false - results are returned for Google search sites","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
Use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"domain or page
required field
the domain name of the target website or the url of the target page;
note: to obtain keywords for the target website, use the target_type parameter","type":"string"},"target_type":{"description":"search keywords for site or url
optional field
possible values: site, page;
default value: page
if set to site, keywords will be provided for the entire site;
if set to page, keywords will be provided for the specified webpage","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsSearchVolumeLiveRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
date format: \"yyyy-mm-dd\"
minimal value: 4 years from the current date
by default, data is returned for the past 12 months;
Note: the indicated date cannot be greater than that specified in date_to and/or yesterday's date;if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
Note: the indicated date cannot be greater than the past month, Google Ads does not return data on the current month;
if you don't specify this field, yesterday's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2022-11-30\"","type":["string","null"]},"include_adult_keywords":{"description":"include keywords associated with adult content
optional field
if set to_true, adult keywords will be included in the response
default value:_false
note_that the API may return no data for such keywords due to_Google Ads restrictionsn","type":["boolean","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the keywords you specify will be converted to a lowercase format
Note #1: Google Ads may return no data for certain groups of keywords;
Note #2: Google Ads provides combined search volume values for groups of similar keywords
to obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;
Note #3: Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"search_partners":{"description":"include Google search partners
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search;
default value: false - results are returned for Google search sites","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data array of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskPostRequestInfo":{"properties":{"date_from":{"description":"starting date of the time range
optional field
date format: \"yyyy-mm-dd\"
minimal value: 4 years from the current date
by default, data is returned for the past 12 months;
Note: the indicated date cannot be greater than that specified in date_to and/or yesterday's date;
if Status endpoint returns false in the actual_data field, date_from can be set to the month before last and prior;
if Status endpoint returns true in the actual_data field, date_from can be set to the last month and prior","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
Note: the indicated date cannot be greater than the past month, Google Ads does not return data on the current month;
if you don't specify this field, yesterday's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2022-11-30\"","type":["string","null"]},"include_adult_keywords":{"description":"include keywords associated with adult content
optional field
if set to_true, adult keywords will be included in the response
default value:_false
note_that the API may return no data for such keywords due to_Google Ads restrictionsn","type":["boolean","null"]},"keywords":{"description":"keywords
required field
The maximum number of keywords you can specify: 1000
The maximum number of characters for each keyword: 80
The maximum number of words for each keyword phrase: 10
the keywords you specify will be converted to a lowercase format
Note #1: Google Ads may return no data for certain groups of keywords;
Note #2: Google Ads provides combined search volume values for groups of similar keywords
to obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;
Note #3: Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;
to learn more about which symbols and characters can be used, please refer to this articlekeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_coordinate;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:2840","type":["integer","null"]},"location_coordinate":{"description":"GPS coordinates of a location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_name or location_code;location_coordinate parameter should be specified in the \"latitude,longitude\" format;
the data will be provided for the country the specified coordinates belong to;
example:52.6178549,-155.352142","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_ads/locations
example:London,England,United Kingdom","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
if you specify true, the results will be delivered for owned, operated, and syndicated networks across Google and partner sites that host Google search;
default value: false - results are returned for Google search sites","type":["boolean","null"]},"sort_by":{"description":"results sorting parameters
optional field
use these parameters to sort the results by relevance, search_volume, competition_index, low_top_of_page_bid, or high_top_of_page_bid in the descending order
default value: relevance","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data array of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleTrendsExploreLiveRequestInfo":{"properties":{"category_code":{"description":"google trends search category
required field if you don't specify `keywords`
if you don't specify `keywords`, the value of this field must be greater than `0`
if you specify `keywords` and don't specify this field, the 0 value will be applied by default and the search will be carried out across all available categories
you can receive the list of available categories with their category_code by making a separate request to the https://api.dataforseo.com/v3/keywords_data/google_trends/categories","type":"integer"},"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the current day and month of the preceding year will be used by default
minimal value for the web type: 2004-01-01
minimal value for other types: 2008-01-01
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"item_types":{"description":"types of items returned
optional field
to speed up the execution of the request, specify one item at a time;
possible values:\"google_trends_graph\", \"google_trends_map\", \"google_trends_topics_list\",\"google_trends_queries_list\"
default value:\"google_trends_graph\"google_trends_topics_list and google_trends_queries_list items, specify no more than 1 keyword in the keywords field","items":{"type":"string"},"type":["array","null"]},"keywords":{"description":"keywords
required field if you don't specify `category_code`
the maximum number of keywords you can specify: 5
the maximum number of characters you can specify in a keyword: 100
the minimum number of characters must be greater than 1
comma characters (,) in the specified keywords will be unset and ignored< > | \" - + = ~ ! : * ( ) [ ] { }google_trends_topics_list and google_trends_queries_list items, specify no more than 1 keywordkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
default value: en
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
default value: English
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_name
you can use this field as an array to set several locations, each corresponding to a specific keyword - learn more;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/locations
example:2840","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_code
you can use this field as an array to set several locations, each corresponding to a specific keyword - learn more;
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/locations
example:United Kingdom","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"time_range":{"description":"preset time ranges
optional field
if you specify date_from or date_to parameters, this field will be ignored when setting a task
possible values for all type parameters:past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
possible values for web only:2004_present
possible values for news, youtube, images, froogle:2008_present","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_KeywordsDataGoogleTrendsExploreTaskPostRequestInfo":{"properties":{"category_code":{"description":"google trends search category
required field if you don't specify `keywords`
if you don't specify `keywords`, the value of this field must be greater than `0`
if you specify `keywords` and don't specify this field, the 0 value will be applied by default and the search will be carried out across all available categories
you can receive the list of available categories with their category_code by making a separate request to the https://api.dataforseo.com/v3/keywords_data/google_trends/categories","type":"integer"},"date_from":{"description":"starting date of the time range
optional field
if you don't specify this field, the current day and month of the preceding year will be used by default
minimal value for the web type: 2004-01-01
minimal value for other types: 2008-01-01
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"date_to":{"description":"ending date of the time range
optional field
if you don't specify this field, the today's date will be used by default
date format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"item_types":{"description":"types of items returned
optional field
to speed up the execution of the request, specify one item at a time;
possible values:\"google_trends_graph\", \"google_trends_map\", \"google_trends_topics_list\",\"google_trends_queries_list\"
default value:\"google_trends_graph\"google_trends_topics_list and google_trends_queries_list items, specify no more than 1 keyword in the keywords field","items":{"type":"string"},"type":["array","null"]},"keywords":{"description":"keywords
required field if you don't specify `category_code`
the maximum number of keywords you can specify: 5
the maximum number of characters you can specify in a keyword: 100
the minimum number of characters must be greater than 1
comma characters (,) in the specified keywords will be unset and ignored< > | \" - + = ~ ! : * ( ) [ ] { }google_trends_topics_list and google_trends_queries_list items, specify no more than 1 keywordkeyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"search engine language code
optional field
default value: en
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/languages
example:en","type":["string","null"]},"language_name":{"description":"full name of search engine language
optional field
default value: English
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/languages
example:English","type":["string","null"]},"location_code":{"description":"search engine location code
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_name
you can use this field as an array to set several locations, each corresponding to a specific keyword - learn more;
you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/locations
example:2840","type":["string","null"]},"location_name":{"description":"full name of search engine location
optional field
if you don't use this field, you will recieve global results
if you use this field, you don't need to specify location_code
you can use this field as an array to set several locations, each corresponding to a specific keyword - learn more;
you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/google_trends/locations
example:United Kingdom","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"time_range":{"description":"preset time ranges
optional field
if you specify date_from or date_to parameters, this field will be ignored when setting a task
possible values for all type parameters:past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
possible values for web only:2004_present
possible values for news, youtube, images, froogle:2008_present","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_LlmMessageChainItem":{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonAsinLiveAdvancedRequestInfo":{"properties":{"asin":{"description":"product ID
required field
unique product identifier (ASIN) in Amazon
you can receive the asin parameter by making a separate request to the Amazon Products endpoint","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_GB","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United Kingdom)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/locations
example:9045969","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:HA1,England,United Kingdom","type":"string"},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.com, amazon.co.uk, amazon.fr, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonAsinLiveHtmlRequestInfo":{"properties":{"asin":{"description":"product ID
required field
unique product identifier (ASIN) in Amazon
you can receive the asin parameter by making a separate request to the Amazon Products endpoint","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_GB","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United Kingdom)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/locations
example:9045969","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:HA1,England,United Kingdom","type":"string"},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.com, amazon.co.uk, amazon.fr, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonAsinTaskPostRequestInfo":{"properties":{"asin":{"description":"product ID
required field
unique product identifier (ASIN) in Amazon
you can receive the asin parameter by making a separate request to the Amazon Products endpoint","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_GB","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United Kingdom)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/locations
example:9045969n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:HA1,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.com, amazon.co.uk, amazon.fr, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonProductsLiveAdvancedRequestInfo":{"properties":{"department":{"description":"amazon product department
optional field
specify one of the following amazon departments for extracting product listings:\"Arts & Crafts\", \"Automotive\", \"Baby\", \"Beauty & Personal Care\", \"Books\", \"Computers\", \"Digital Music\", \"Electronics\", \"Kindle Store\", \"Prime Video\", \"Women's Fashion\", \"Men's Fashion\", \"Girls' Fashion\", \"Boys' Fashion\", \"Deals\", \"Health & Household\", \"Home & Kitchen\", \"Industrial & Scientific\", \"Luggage\", \"Movies & TV\", \"Music, CDs & Vinyl\", \"Pet Supplies\", \"Software\", \"Sports & Outdoors\", \"Tools & Home Improvement\", \"Toys & Games\", \"Video Games\"","type":["string","null"]},"depth":{"description":"parsing depth
optional field
number of results to be retrieved from the Amazon results page
default value: 100
max value: 700
Your account will be billed per each SERP containing up to 100 results;
Setting depth above 100 may result in additional charges if the search engine returns more than 100 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in this field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_GB","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United Kingdom)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/locations
example:9045969","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:HA1,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
max value: 7
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"price_max":{"description":"maximum product price
optional field
maximum price of the returned products listed on Amazon for the specified query
example:100
Note: if you specify price_max, the search_param parameter will be ignored","type":["integer","null"]},"price_min":{"description":"minimum product price
optional field
minimum price of the returned products listed on Amazon for the specified query
example:5
Note: if you specify price_min, the search_param parameter will be ignored","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.com, amazon.co.uk, amazon.fr, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
you can use the following Amazon search URL parameters for customizing the search
example:&low-price=52 - search for products that cost more than 52 USD;&high-price=45 - search for products that cost less than 45 USD;&sort=relevancerank - sort results by relevance;&sort=featured-rank - sort results by featured products;&sort=price-asc-rank - sort by ascending price;&sort=price-desc-rank - sort by descending price;&sort=review-rank - sort by the average customer reviews value;&sort=date-desc-rank - sort by the newest arrival
Note that search_param values will be ignored if any of the following parameters is used: price_min, price_max, sort_by","type":["string","null"]},"sort_by":{"description":"results sorting rules
optional field
the following sorting rules are supported:relevance, price_low_to_high, price_high_to_low, featured, avg_customer_review, newest_arrival
example:sort_by:\"relevance\"
Note: if you specify sort_by, the search_param parameter will be ignored","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://www.amazon.com/s/?field-keywords=shoes&language=en_US","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonProductsLiveHtmlRequestInfo":{"properties":{"department":{"description":"amazon product department
optional field
specify one of the following amazon departments for extracting product listings:\"Arts & Crafts\", \"Automotive\", \"Baby\", \"Beauty & Personal Care\", \"Books\", \"Computers\", \"Digital Music\", \"Electronics\", \"Kindle Store\", \"Prime Video\", \"Women's Fashion\", \"Men's Fashion\", \"Girls' Fashion\", \"Boys' Fashion\", \"Deals\", \"Health & Household\", \"Home & Kitchen\", \"Industrial & Scientific\", \"Luggage\", \"Movies & TV\", \"Music, CDs & Vinyl\", \"Pet Supplies\", \"Software\", \"Sports & Outdoors\", \"Tools & Home Improvement\", \"Toys & Games\", \"Video Games\"","type":["string","null"]},"depth":{"description":"parsing depth
optional field
number of results to be retrieved from the Amazon results page
default value: 100
max value: 700
Your account will be billed per each SERP containing up to 100 results;
Setting depth above 100 may result in additional charges if the search engine returns more than 100 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in this field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_GB","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United Kingdom)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/locations
example:9045969","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:HA1,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
max value: 7
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"price_max":{"description":"maximum product price
optional field
maximum price of the returned products listed on Amazon for the specified query
example:100
Note: if you specify price_max, the search_param parameter will be ignored","type":["integer","null"]},"price_min":{"description":"minimum product price
optional field
minimum price of the returned products listed on Amazon for the specified query
example:5
Note: if you specify price_min, the search_param parameter will be ignored","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.com, amazon.co.uk, amazon.fr, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
you can use the following Amazon search URL parameters for customizing the search
example:&low-price=52 - search for products that cost more than 52 USD;&high-price=45 - search for products that cost less than 45 USD;&sort=relevancerank - sort results by relevance;&sort=featured-rank - sort results by featured products;&sort=price-asc-rank - sort by ascending price;&sort=price-desc-rank - sort by descending price;&sort=review-rank - sort by the average customer reviews value;&sort=date-desc-rank - sort by the newest arrival
Note that search_param values will be ignored if any of the following parameters is used: price_min, price_max, sort_by","type":["string","null"]},"sort_by":{"description":"results sorting rules
optional field
the following sorting rules are supported:relevance, price_low_to_high, price_high_to_low, featured, avg_customer_review, newest_arrival
example:sort_by:\"relevance\"
Note: if you specify sort_by, the search_param parameter will be ignored","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://www.amazon.com/s/?field-keywords=shoes&language=en_US","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonProductsTaskPostRequestInfo":{"properties":{"department":{"description":"amazon product department
optional field
specify one of the following amazon departments for extracting product listings:\"Arts & Crafts\", \"Automotive\", \"Baby\", \"Beauty & Personal Care\", \"Books\", \"Computers\", \"Digital Music\", \"Electronics\", \"Kindle Store\", \"Prime Video\", \"Women's Fashion\", \"Men's Fashion\", \"Girls' Fashion\", \"Boys' Fashion\", \"Deals\", \"Health & Household\", \"Home & Kitchen\", \"Industrial & Scientific\", \"Luggage\", \"Movies & TV\", \"Music, CDs & Vinyl\", \"Pet Supplies\", \"Software\", \"Sports & Outdoors\", \"Tools & Home Improvement\", \"Toys & Games\", \"Video Games\"","type":["string","null"]},"depth":{"description":"parsing depth
optional field
number of results to be retrieved from the Amazon results page
default value: 100
max value: 700
Your account will be billed per each SERP containing up to 100 results;
Setting depth above 100 may result in additional charges if the search engine returns more than 100 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in this field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code_parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_GB","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United Kingdom)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations with their location_code parameters by making a separate request to thehttps://api.dataforseo.com/v3/merchant/amazon/locations
example:9045969","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations with their location_name parameters by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:HA1,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
max value: 7
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
maximum price of the returned products listed on Amazon for the specified query
example:100
Note: if you specify price_max, the search_param parameter will be ignored","type":["integer","null"]},"price_min":{"description":"minimum product price
optional field
minimum price of the returned products listed on Amazon for the specified query
example:5
Note: if you specify price_min, the search_param parameter will be ignored","type":["integer","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.com, amazon.co.uk, amazon.fr, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
you can use the following Amazon search URL parameters for customizing the search
example:&low-price=52 - search for products that cost more than 52 USD;&high-price=45 - search for products that cost less than 45 USD;&sort=relevancerank - sort results by relevance;&sort=featured-rank - sort results by featured products;&sort=price-asc-rank - sort by ascending price;&sort=price-desc-rank - sort by descending price;&sort=review-rank - sort by the average customer reviews value;&sort=date-desc-rank - sort by the newest arrival
Note that search_param values will be ignored if any of the following parameters is used: price_min, price_max, sort_by","type":["string","null"]},"sort_by":{"description":"results sorting rules
optional field
the following sorting rules are supported:relevance, price_low_to_high, price_high_to_low, featured, avg_customer_review, newest_arrival
example:sort_by:\"relevance\"
Note: if you specify sort_by, the search_param parameter will be ignored","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://www.amazon.com/s/?field-keywords=shoes&language=en_US","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonSellersLiveAdvancedRequestInfo":{"properties":{"asin":{"description":"unique product identifier on Amazon
required field
you can get this value making a separate request to the Amazon Products endpoint
note that there is no full list of possible values as the asin values is a dynamic value assigned by Amazon
example:B085RFFC9Q
learn more about the identifier in this help center guide","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available Amazon languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_US","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available Amazon languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United States)","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available Amazon locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of the location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available Amazon locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:London,England,United Kingdom","type":"string"},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.co.uk, amazon.com.au, amazon.de, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonSellersLiveHtmlRequestInfo":{"properties":{"asin":{"description":"unique product identifier on Amazon
required field
you can get this value making a separate request to the Amazon Products endpoint
note that there is no full list of possible values as the asin values is a dynamic value assigned by Amazon
example:B085RFFC9Q
learn more about the identifier in this help center guide","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available Amazon languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_US","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available Amazon languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United States)","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available Amazon locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of the location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available Amazon locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:London,England,United Kingdom","type":"string"},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.co.uk, amazon.com.au, amazon.de, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantAmazonSellersTaskPostRequestInfo":{"properties":{"asin":{"description":"unique product identifier on Amazon
required field
you can get this value making a separate request to the Amazon Products endpoint
note that there is no full list of possible values as the asin values is a dynamic value assigned by Amazon
example:B085RFFC9Q
learn more about the identifier in this help center guide","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available Amazon languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:en_US","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available Amazon languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/languages
example:English (United States)","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available Amazon locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of the location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available Amazon locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/merchant/amazon/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:amazon.co.uk, amazon.com.au, amazon.de, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantGoogleProductInfoTaskPostRequestInfo":{"properties":{"data_docid":{"description":"unique identifier of the SERP data element
required field if product_id or gid is not specified
we recommend specifying data_docid together with product_id and gid for optimal results;
you can get this value for a certain element by making a separate request to the Google Shopping Products endpoint
example:13071766526042404278","type":"string"},"gid":{"description":"global product identifier on Google Shopping
required field if product_id or data_docid is not specified
we recommend specifying gid together with product_id and data_docid for optimal results;
you can get this value for a certain product by making a separate request to the Google Shopping Products endpoint
example:4702526954592161872
learn more about the parameter in this help center guide","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available Google Shopping languages with their language_code_by making a separate request to the https://api.dataforseo.com/v3/merchant/google/languages
example:en","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available Google Shopping languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/merchant/google/languages
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available Google Shopping locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/merchant/google/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of the location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available Google Shopping locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/merchant/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
corresponds to the datatype that will be sent to your server
possible values:advanced","type":["string","null"]},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"product_id":{"description":"unique product identifier on Google Shopping
required field if data_docid or gid is not specified
we recommend specifying product_id together with data_docid and gid for optimal results;
you can get this value for a certain product by making a separate request to the Google Shopping Products endpoint
example:4485466949985702538
learn more about the parameter in this help center guide","type":"string"},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:google.co.uk, google.com.au, google.de, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantGoogleProductsTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results to be retrieved from Google Shopping SERP
default value: 40
max value: 120
Your account will be billed per each SERP containing up to 40 results;
Setting depth above 40 may result in additional charges if the search engine returns more than 40 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword filed
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available Google Shopping languages with their language_code_by making a separate request to the https://api.dataforseo.com/v3/merchant/google/languages
example:en","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available Google Shopping languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/merchant/google/languages
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available Google Shopping locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/merchant/google/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of the location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available Google Shopping locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/merchant/google/locations
example:London,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
max value: 7
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
maximum price of the returned products listed on Google Shopping for the specified query
example:100
Note: if you specify price_max, the search_param parameter will be ignored","type":["integer","null"]},"price_min":{"description":"minimum product price
optional field
minimum price of the returned products listed on Google Shopping for the specified query
example:5
Note: if you specify price_min, the search_param parameter will be ignored","type":["integer","null"]},"priority":{"description":"task priority
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:google.co.uk, google.com.au, google.de, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
you can use the following search URL parameters for customizing the search;
example:&tbs=ppr_min:45 – search for products that cost more than 45 USD;&tbs=ppr_max:50 – search for products that cost less than 50 USD;&tbs=p_ord:p – sort by ascending price;&tbs=p_ord:pd – sort by descending price;&tbs=p_ord:rv – sort by review score;&tbs=ppr_max:50,p_ord:rv – sort by review score with the maximum price of 50 USD.;&udm=28 – use new Google Shopping markup with 40 SERP results returned by default (the cost for one SERP is deducted accordingly); the maximum depth is 200; this parameter must be specified without tbm=shop in the url;&shoprs=$value – specify advanced filtering and sorting in the new Shopping markup; replace $value with a string in protobuf Base64 format; learn more on our help center.
Note that search_param values will be ignored if any of the following parameters are used: price_min, price_max, sort_by","type":["string","null"]},"sort_by":{"description":"results sorting rules
optional field
the following sorting rules are supported:review_score, price_low_to_high, price_high_to_low
example:sort_by:\"review_score\"
Note: if you specify sort_by, the search_param parameter will be ignored","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://www.google.com/search?q=fish&hl=en&gl=US&gws_rd=cr&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_MerchantGoogleSellersTaskPostRequestInfo":{"properties":{"additional_specifications":{"additionalProperties":{"type":["string","null"]},"description":"object containing additional url parameters
you can get additional information about the product by using the \"additional_specifications object, which you can get by making a separate request to the Google Shopping Products endpoint
example:\"additional_specifications\": {","type":["object","null"]},"data_docid":{"description":"unique identifier of the SERP data element
\"eto\": \"16157121050167572763_0\"
}
required field if product_id or gid is not specified
we recommend specifying data_docid together with product_id and gid for optimal results;
you can get this value for a certain element by making a separate request to the Google Shopping Products endpoint
example:13071766526042404278","type":"string"},"depth":{"description":"parsing depth
optional field
number of results to be retrieved from Google Shopping SERP
default value: 10
max value: 200
your account will be billed per each SERP containing up to 10 results;
setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
the cost can be calculated on the Pricing page","type":["integer","null"]},"get_shops_on_google":{"description":"include \"buy on Google\" shops
optional field
if set to true, the response will contain the list of sellers that allow to purchase a given product directly on Google
Note: if set to true, the cost of a task will be doubled","type":["boolean","null"]},"gid":{"description":"global product identifier on Google Shopping
required field if product_id or data_docid is not specified
we recommend specifying gid together with product_id and data_docid for optimal results;
you can get this value for a certain product by making a separate request to the Google Shopping Products endpoint
example:4702526954592161872
learn more about the parameter in this help center guide","type":"string"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available Google Shopping languages with their language_code_by making a separate request to the https://api.dataforseo.com/v3/merchant/google/languages
example:en","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available Google Shopping languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/merchant/google/languages
example:English","type":"string"},"location_code":{"description":"location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available Google Shopping locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/merchant/google/locations
example:2840","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of the location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available Google Shopping locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/merchant/google/locations
example:London,England,United Kingdom","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"product_id":{"description":"unique product identifier on Google Shopping
required field if data_docid or gid is not specified
we recommend specifying product_id together with data_docid and gid for optimal results;
you can get this value for a certain product by making a separate request to the Google Shopping Products endpoint
example:4485466949985702538
learn more about the parameter in this help center guide","type":"string"},"pvf":{"description":"product variant filter on Google Shopping
optional field
parameter in Google Shopping URL, setting optional product variant filtration;
example:Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs","type":["string","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:google.co.uk, google.com.au, google.de, etc.","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageContentParsingLiveRequestInfo":{"properties":{"accept_language":{"description":"language header for accessing the website
optional field
all locale formats are supported (xx, xx-XX, xxx-XX, etc.)
Note: if you do not specify this parameter, some websites may deny access; in this case, pages will be returned with the \"type\":\"broken in the response array","type":["string","null"]},"browser_preset":{"description":"preset for browser screen parameters
optional field
if you use this field, you don't need to indicate browser_screen_width, browser_screen_height, browser_screen_scale_factordesktop, mobile, tabletdesktop preset will apply the following values:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobile preset will apply the following values:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tablet preset will apply the following values:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2enable_javascript or enable_browser_rendering to true","type":["string","null"]},"browser_screen_height":{"description":"browser screen height
optional field
you can set a custom browser screen height to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;enable_javascript or enable_browser_rendering to true240
maximum value, in pixels: 9999","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser screen scale factor
optional field
you can set a custom browser screen resolution ratio to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;enable_javascript or enable_browser_rendering to true0.5
maximum value: 3","type":["number","null"]},"browser_screen_width":{"description":"browser screen width
optional field
you can set a custom browser screen width to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;enable_javascript or enable_browser_rendering to true240
maximum value, in pixels: 9999","format":"int64","type":["integer","null"]},"custom_user_agent":{"description":"custom user agent
optional field
custom user agent for crawling a website
example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
default value: Mozilla/5.0 (compatible; RSiteAuditor)","type":["string","null"]},"disable_cookie_popup":{"description":"disable the cookie popup
optional field
set to true if you want to disable the popup requesting cookie consent from the user;
default value:false","type":["boolean","null"]},"enable_browser_rendering":{"description":"emulate browser rendering to measure Core Web Vitals
optional field
by using this parameter you will be able to emulate a browser when loading a web page;enable_browser_rendering loads styles, images, fonts, animations, videos, and other resources on a page;
default value: false
set to true to obtain Core Web Vitals (FID, CLS, LCP) metrics in the response;
if you use this field, enable_javascript, and load_resources parameters must be set to true
Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"enable_javascript":{"description":"load javascript on a page
optional field
set to true if you want to load the scripts available on a page
default value: false
Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"enable_xhr":{"description":"enable XMLHttpRequest on a page
optional field
set to true if you want our crawler to request data from a web server using the XMLHttpRequest object
default value:falseenable_javascript must be set to true;","type":["boolean","null"]},"ip_pool_for_scan":{"description":"proxy pool
optional field
you can choose a location of the proxy pool that will be used to obtain the requested data;
the parameter can be used if page content is inaccessible in one of the locations, resulting in occasional site_unreachable errors
possible values: us, de","type":["string","null"]},"markdown_view":{"description":"return page content as markdown
optional field
if set to true, the markdown-formatted content of the page will be returned in the page_as_markdown field of the response;
default value: false","type":["boolean","null"]},"store_raw_html":{"description":"store HTML of a crawled page
optional field
set to true if you want to get the HTML of the page using the OnPage Raw HTML endpoint
default value: false","type":["boolean","null"]},"switch_pool":{"description":"switch proxy pool
optional field
if true, additional proxy pools will be used to obtain the requested data;
the parameter can be used if a multitude of tasks is set simultaneously, resulting in occasional rate-limit and/or site_unreachable errors","type":["boolean","null"]},"url":{"description":"URL of the content to parse
required field
URL of the page to parse
example:
`https://www.fujielectric.com/`","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageContentParsingRequestInfo":{"properties":{"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
note: the enable_content_parsing parameter in the POST request must be set to true
example:\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"markdown_view":{"description":"return page content as markdown
optional field
if set to true, the markdown-formatted content of the page will be returned in the page_as_markdown field of the response;
default value: false","type":["boolean","null"]},"url":{"description":"URL of the content to parse
required field
URL of the page to parse
example:
`https://dataforseo.com/blog/a-versatile-alternative-to-google-trends-exploring-the-power-of-dataforseo-trends-api`","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageDuplicateContentRequestInfo":{"properties":{"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned pages
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned pages
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"similarity":{"description":"content similarity score
by default, the content is considered duplicate if the value is greater than or equals 6
you can specify any similarity score in the 0-to-10 range","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"page URL
required field
specify the initial page you want to receive duplicate content for","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageDuplicateTagsRequestInfo":{"properties":{"accumulator":{"description":"tag value
optional field
specify a title or description here if you want to receive a list of duplicate pages that contains this tag","type":["string","null"]},"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned pages
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned pages
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"type":{"description":"type of element","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageForceStopRequestInfo":{"properties":{"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"id values as separate objects in the POST array","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageInstantPagesRequestInfo":{"properties":{"accept_language":{"description":"language header for accessing the websiteoptional fieldall locale formats are supported (xx, xx-XX, xxx-XX, etc.)Note: if you do not specify this parameter, some websites may deny access; in this case, pages will be returned with the \"type\":\"broken in the response array","type":["string","null"]},"browser_preset":{"description":"preset for browser screen parametersoptional fieldif you use this field, you don't need to indicate browser_screen_width, browser_screen_height, browser_screen_scale_factorpossible values:desktop, mobile, tabletdesktop preset will apply the following values:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobile preset will apply the following values:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tablet preset will apply the following values:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2Note: to use this parameter, set enable_javascript or enable_browser_rendering to true","type":["string","null"]},"browser_screen_height":{"description":"browser screen heightoptional fieldyou can set a custom browser screen height to perform audit for a particular device;if you use this field, you don't need to indicate browser_preset as it will be ignored;Note: to use this parameter, set enable_javascript or enable_browser_rendering to trueminimum value, in pixels: 240maximum value, in pixels: 9999","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser screen scale factoroptional fieldyou can set a custom browser screen resolution ratio to perform audit for a particular device;if you use this field, you don't need to indicate browser_preset as it will be ignored;Note: to use this parameter, set enable_javascript or enable_browser_rendering to trueminimum value: 0.5maximum value: 3","type":["number","null"]},"browser_screen_width":{"description":"browser screen widthoptional fieldyou can set a custom browser screen width to perform audit for a particular device;if you use this field, you don't need to indicate browser_preset as it will be ignored;Note: to use this parameter, set enable_javascript or enable_browser_rendering to trueminimum value, in pixels: 240maximum value, in pixels: 9999","format":"int64","type":["integer","null"]},"check_spell":{"description":"check spellingoptional fieldset to true to check spelling on a website using Hunspell librarydefault value: false","type":["boolean","null"]},"checks_threshold":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"custom threshold values for checksoptional fieldyou can specify custom threshold values for the parameters included in the checks array of OnPage API responses;Note: only integer threshold values can be modified;","type":["object","null"]},"custom_js":{"description":"custom javascriptoptional fieldNote that the execution time for the script you enter here should be 700 ms maximum;for example, you can use the following JS snippet to check if the website contains Google Tag Manager as a scr attribute:let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute(\"src\");rn if (src != undefined) {rn if (src.indexOf(\"analytics.js\") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf(\"gtm.js\") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;the returned value depends on what you specified in this field. For instance, if you specify the following script:meta = {}; meta.url = document.URL; meta.test = 'test'; meta;as a response you will receive the following data:\"custom_js_response\": {\"url\": \"https://dataforseo.com/\",\"test\": \"test\"}","type":["string","null"]},"custom_user_agent":{"description":"custom user agentoptional fieldcustom user agent for crawling a websiteexample: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36default value: Mozilla/5.0 (compatible; RSiteAuditor)","type":["string","null"]},"disable_cookie_popup":{"description":"disable the cookie popup optional fieldset to true if you want to disable the popup requesting cookie consent from the user;default value:false","type":["boolean","null"]},"enable_browser_rendering":{"description":"emulate browser rendering to measure Core Web Vitalsoptional fieldby using this parameter you will be able to emulate a browser when loading a web page;enable_browser_rendering loads styles, images, fonts, animations, videos, and other resources on a page;default value: falseset to true to obtain Core Web Vitals (FID, CLS, LCP) metrics in the response;if you use this field, parameters enable_javascript, and load_resources are enabled automatically;Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"enable_javascript":{"description":"load javascript on a pageoptional fieldset to true if you want to load the scripts available on a pagedefault value: falseNote: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"enable_xhr":{"description":"enable XMLHttpRequest on a pageoptional fieldset to true if you want our crawler to request data from a web server using the XMLHttpRequest objectdefault value:falseif you use this field, enable_javascript must be set to true;","type":["boolean","null"]},"ip_pool_for_scan":{"description":"proxy pooloptional fieldyou can choose a location of the proxy pool that will be used to obtain the requested data;the parameter can be used if page content is inaccessible in one of the locations, resulting in occasional site_unreachable errorspossible values: us, de","type":["string","null"]},"load_resources":{"description":"load resourcesoptional fieldset to true if you want to load image, stylesheets, scripts, and broken resourcesdefault value: falseNote: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"return_despite_timeout":{"description":"return data on pages despite the timeout erroroptional fieldif true, the data will be provided on pages that failed to load within 120 seconds and responded with a timeout error;default value: false","type":["boolean","null"]},"store_raw_html":{"description":"store HTML of a crawled pageoptional fieldset to true if you want get the HTML of the page using the OnPage Raw HTML endpointdefault value: false","type":["boolean","null"]},"switch_pool":{"description":"switch proxy pooloptional fieldif true, additional proxy pools will be used to obtain the requested data;the parameter can be used if a multitude of tasks is set simultaneously, resulting in occasional rate-limit and/or site_unreachable errors","type":["boolean","null"]},"url":{"description":"target page urlrequired fieldabsolute URL of the target page;Note #1: results will be returned for the specified URL only;Note #2: to prevent denial-of-service events, tasks that contain a duplicate crawl host will be returned with a 40501 error;to prevent this error from occurring, avoid setting tasks with the same domain if at least one of your previous tasks with this domain (including a page URL on the domain) is still in a crawling queue","type":"string"},"validate_micromarkup":{"description":"enable microdata validationoptional fieldif set to true, you can use the OnPage API Microdata endpoint with the id of the task;default value: false","type":["boolean","null"]}},"type":"object"},"Provider0A3E90081762_OnPageKeywordDensityRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"keyword\",\"=\",\"%seo%\"][[\"keyword\",\"=\",\"%seo%\"],
\"and\",
[\"frequency\",\"<\",\"6\"]][[\"keyword\",\"not_like\",\"%seo%\"],
\"and\",
[[\"frequency\",\">\",\"6\"],\"or\",[\"density\",\">\",\"0.02\"]]]
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"keyword_length":{"description":"number of words for a keyword
required field
possible values:1, 2, 3, 4, 5","type":"integer"},"limit":{"description":"the maximum number of returned keywords
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"frequency,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"keyword,asc\",\"frequency,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"page URL
optional field
if you do not specify a page here, the results will be provided for the whole website
if you use this field, the API response will contain only keywords from the specified page
a page should be specified with absolute URL (including http:// or https://)","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageLighthouseLiveJsonRequestInfo":{"properties":{"audits":{"description":"Lighthouse audits
optional field
audits are individual tests Lighthouse runs for each specific feature/optimization/metric to produce a numeric score (see official definition);
use this field to get data for specific audits you indicate here;categories, you can use this field to get data for the specified audits only
for example, if you ignore \"categories\" and specify \"audits\": [\"metrics/cumulative-layout-shift\",\"metrics/largest-contentful-paint\",\"metrics/total-blocking-time\"], you will get data only for these audits
for example, if you specify \"categories\": [\"seo\"] and \"audits\": [\"metrics/cumulative-layout-shift\",\"metrics/largest-contentful-paint\",\"metrics/total-blocking-time\"], you will get only these audits under \"performance\" and all audits under \"seo\"
required if browser_network_throttling_method is set to devtools;
set the CPU throttling multiplier to simulate device performance conditions during the Lighthouse audit;
can be specified within the following range: 1–4;
Note: this parameter is applied only when browser_network_throttling_method is set to devtools;","type":["number","null"]},"browser_network_throttling":{"description":"browser network throttling
required if browser_network_throttling_method is set to devtools;
set the network throttling profile to simulate connection speed conditions during the Lighthouse audit;
possible values: no_throttling, fast_4g, slow_4g, regular_3g, pc;
Note: this parameter is applied only when browser_network_throttling_method is set to devtools;","type":["string","null"]},"browser_network_throttling_method":{"description":"browser network throttling method
optional field
defines the method used to apply throttling during the Lighthouse audit;
possible vaules:simulate - calculates estimated performance metrics without applying explicit throttling;devtools - applies the throttling settings specified in browser_network_throttling and browser_cpu_throttling_multiplier;provided - uses the network conditions of the crawling environment;","type":["string","null"]},"browser_screen_height":{"description":"browser screen height
optional field
set the screen height of the browser used for the Lighthouse audit to emulate a specific device;
can be specified within the following range: 240–9999;","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser screen scale factor
optional field
set the device pixel ratio of the browser used for the Lighthouse audit;
can be specified within the following range: 0.5–3;","type":["number","null"]},"browser_screen_width":{"description":"browser screen width
optional field
set the screen width of the browser used for the Lighthouse audit to emulate a specific device;
can be specified within the following range: 240–9999;","format":"int64","type":["integer","null"]},"categories":{"description":"categories of Lighthouse audits
optional field
each category is a collection of audits and audit groups that applies weighting and scoring to the section (see official definition)audits
use this field to get data for specific categories you indicate hereseo, performance, best_practices, accessibility","items":{"type":"string"},"type":["array","null"]},"custom_user_agent":{"description":"custom user agent
optional field
specify the custom user agent used by the browser when running the Lighthouse audit;
can be specified with up to 254 characters;","type":["string","null"]},"for_mobile":{"description":"applies mobile emulation
optional field
if set to true, Lighthouse will use mobile device and screen emulation to test the page against mobile environment
if set to false, the results will be provided for desktop
default value: false","type":["boolean","null"]},"language_code":{"description":"lighthouse language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/on_page/lighthouse/languages
default value:en","type":["string","null"]},"language_name":{"description":"lighthouse language name
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/on_page/lighthouse/languages
default value:English","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"target URL
required field
target page should be specified with its absolute URL (including http:// or https://)
example:https://dataforseo.com/","type":"string"},"version":{"description":"lighthouse version
optional field
you can obtain the results specific to a certain Lighthouse version by specifying its number
the list of available versions is available through the Lighthouse Versions endpoint","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageLighthouseTaskPostRequestInfo":{"properties":{"audits":{"description":"Lighthouse audits
optional field
audits are individual tests Lighthouse runs for each specific feature/optimization/metric to produce a numeric score (see official definition)if you ignore this field, we will return data for all audits
use this field to get data for specific audits you indicate herecategories, you can use this field to get data for the specified audits only
for example, if you ignore \"categories\" and specify \"audits\": [\"metrics/cumulative-layout-shift\",\"metrics/largest-contentful-paint\",\"metrics/total-blocking-time\"], you will get data only for these audits
for example, if you specify \"categories\": [\"seo\"] and \"audits\": [\"metrics/cumulative-layout-shift\",\"metrics/largest-contentful-paint\",\"metrics/total-blocking-time\"], you will get only these audits under \"performance\" and all audits under \"seo\"
required if browser_network_throttling_method is set to devtools;
set the CPU throttling multiplier to simulate device performance conditions during the Lighthouse audit;
can be specified within the following range: 1–4;
Note: this parameter is applied only when browser_network_throttling_method is set to devtools;","type":["number","null"]},"browser_network_throttling":{"description":"browser network throttling
required if browser_network_throttling_method is set to devtools;
set the network throttling profile to simulate connection speed conditions during the Lighthouse audit;
possible values: no_throttling, fast_4g, slow_4g, regular_3g, pc;
Note: this parameter is applied only when browser_network_throttling_method is set to devtools;","type":["string","null"]},"browser_network_throttling_method":{"description":"browser network throttling method
optional field
defines the method used to apply throttling during the Lighthouse audit;
possible vaules:simulate - calculates estimated performance metrics without applying explicit throttling;devtools - applies the throttling settings specified in browser_network_throttling and browser_cpu_throttling_multiplier;provided - uses the network conditions of the crawling environment;","type":["string","null"]},"browser_screen_height":{"description":"browser screen height
optional field
set the screen height of the browser used for the Lighthouse audit to emulate a specific device;
can be specified within the following range: 240–9999;","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser screen scale factor
optional field
set the device pixel ratio of the browser used for the Lighthouse audit;
can be specified within the following range: 0.5–3;","type":["number","null"]},"browser_screen_width":{"description":"browser screen width
optional field
set the screen width of the browser used for the Lighthouse audit to emulate a specific device;
can be specified within the following range: 240–9999;","format":"int64","type":["integer","null"]},"categories":{"description":"categories of Lighthouse audits
optional field
each category is a collection of audits and audit groups that applies weighting and scoring to the section (see official definition)if you ignore this field, we will return data for all categories unless you specify audits
use this field to get data for specific categories you indicate hereseo, performance, best_practices, accessibility","items":{"type":"string"},"type":["array","null"]},"custom_user_agent":{"description":"custom user agent
optional field
specify the custom user agent used by the browser when running the Lighthouse audit;
can be specified with up to 254 characters;","type":["string","null"]},"for_mobile":{"description":"applies mobile emulation
optional field
if set to true, Lighthouse will use mobile device and screen emulation to test the page against mobile environment
if set to false, the results will be provided for desktop
default value: false","type":["boolean","null"]},"language_code":{"description":"lighthouse language code
optional field
you can receive the list of available languages of the search engine with their language_code by making a separate request to https://api.dataforseo.com/v3/on_page/lighthouse/languages
default value:en","type":["string","null"]},"language_name":{"description":"lighthouse language name
optional field
you can receive the list of available languages of the search engine with their language_name by making a separate request to https://api.dataforseo.com/v3/on_page/lighthouse/languages
default value:English","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23learn more on our Help Center","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"target URL
required field
target page should be specified with its absolute URL (including http:// or https://)
example:https://dataforseo.com/","type":"string"},"version":{"description":"lighthouse version
optional field
you can obtain the results specific to a certain Lighthouse version by specifying its number
the list of available versions is available through the Lighthouse Versions endpoint","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageLinksRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"direction\",\"=\",\"external\"][[\"domain_to\",\"<>\",\"example.com\"],
\"and\",
[\"link_from\",\"not_like\",\"%example.com/blog%\"]][[\"direction\",\"=\",\"external\"],
\"and\",
[[\"link_from\",\"like\",\"%example.com/blog%\"],\"or\",[\"link_from\",\"like\",\"%example.com/help%\"]]]
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned links
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned links
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten links in the results array will be omitted and the data will be provided for the successive links","type":["integer","null"]},"page_from":{"description":"relative page URL
optional field
if you use this field, the API response will contain only links from the specified page
note that in this field you can specify relative URLs only","type":["string","null"]},"page_to":{"description":"relative page URL
optional field
if you use this field, the API response will contain only internal links pointing to the specified page
note that in this field you can specify relative URLs only","type":["string","null"]},"search_after_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 20,000 results in a single request;
by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;
Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageMicrodataRequestInfo":{"properties":{"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"resource URL
required field
you can get this URL in the response of the Pages endpoint
example:https://dataforseo.com/apis","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageNonIndexableRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[[\"reason\",\"<>\",\"robots_txt\"],
\"and\",
[\"url\",\"not_like\",\"%/wp-admin/%\"]][[\"url\",\"not_like\",\"%/wp-admin/%\"],
\"and\",
[[\"reason\",\"<>\",\"meta_tag\"],\"or\",[\"reason\",\"<>\",\"http_header\"]]]
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned pages
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned pages
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]}},"type":"object"},"Provider0A3E90081762_OnPagePageScreenshotRequestInfo":{"properties":{"accept_language":{"description":"language header for accessing the website
optional field
all locale formats are supported (xx, xx-XX, xxx-XX, etc.)
note: if you do not specify this parameter, some websites may deny access; in this case, you will obtain \"error_message\":\"Screenshot is empty\" in the response array","type":["string","null"]},"browser_preset":{"description":"preset for browser screen parameters
optional field
if you use this field, you don't need to indicate browser_screen_width, browser_screen_height, browser_screen_scale_factordesktop, mobile, tabletdesktop preset will apply the following values:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobile preset will apply the following values:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tablet preset will apply the following values:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2enable_browser_rendering, enable_javascript, load_resources, and enable_xhr parameters are always enabled.","type":["string","null"]},"browser_screen_height":{"description":"browser screen height
optional field
you can set a custom browser screen height to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;240
maximum value, in pixels: 9999","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser screen scale factor
optional field
you can set a custom browser screen resolution ratio to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;0.5
maximum value: 3","type":["number","null"]},"browser_screen_width":{"description":"browser screen width
optional field
you can set a custom browser screen width to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;240
maximum value, in pixels: 9999","format":"int64","type":["integer","null"]},"custom_user_agent":{"description":"custom user agent
optional field
custom user agent for crawling a website
example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
default value: Mozilla/5.0 (compatible; RSiteAuditor)","type":["string","null"]},"disable_cookie_popup":{"description":"disable the cookie popup
optional field
set to true if you want to disable the popup requesting cookie consent from the user;
default value: false","type":["boolean","null"]},"full_page_screenshot":{"description":"take a screenshot of the full page
optional field
set to false if you want to capture only the part of the page displayed before scrolling
default value: true","type":["boolean","null"]},"ip_pool_for_scan":{"description":"proxy pool
optional field
you can choose a location of the proxy pool that will be used to obtain the requested data;
the parameter can be used if page content is inaccessible in one of the locations, resulting in occasional site_unreachable errors
possible values: us, de","type":["string","null"]},"switch_pool":{"description":"switch proxy pool
optional field
if true, additional proxy pools will be used to obtain the requested data;
the parameter can be used if a multitude of tasks is set simultaneously, resulting in occasional rate-limit and/or site_unreachable errors","type":["boolean","null"]},"url":{"description":"page url
required field
absolute URL of the page to snap
note: if the URL you indicate here returns a 404 status code or the indicated value is not a valid URL, you will obtain \"error_message\":\"Screenshot is empty\" in the response array","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPagePagesByResourceRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"meta.external_links_count\",\"<=\",50][\"url\",\"like\",\"https://dataforseo.com/apis/dataforseo-labs-api\"][[\"checks.high_waiting_time\",\"=\",false],
\"and\",[\"resource_type\",\"=\",\"html\"]][[\"page_timing.duration_time\",\"<\",100],\"and\",[[\"checks.large_page_size\",\"=\",false],\"or\",[\"checks.high_waiting_time\",\"=\",false]]]
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned pages
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned pages
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"meta.external_links_count,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"page_timing.dom_complete,asc\",\"size,desc\"]","items":{"type":"string"},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"resource URL
required field
you can get this URL in the response of the Resources endpoint
example:https://ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPagePagesRequestInfo":{"properties":{"filters":{"description":"array of results filtering parametersoptional fieldyou can add several filters at once (8 filters maximum)you should set a logical operator and, or between the conditionsthe following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_likeyou can use the % operator with like and not_like to match any string of zero or more charactersexample:[\"meta.external_links_count\",\"<=\",50][\"url\",\"like\",\"https://dataforseo.com/apis/dataforseo-labs-api\"][[\"checks.high_waiting_time\",\"=\",false],\"and\",[\"resource_type\",\"=\",\"html\"]][[\"page_timing.duration_time\",\"<\",100],\"and\",[[\"checks.large_page_size\",\"=\",false],\"or\",[\"checks.high_waiting_time\",\"=\",false]]]The full list of possible filters is available by this link.","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the taskrequired fieldyou can get this ID in the response of the Task POST endpointexample:\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned pagesoptional fielddefault value: 100maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned pagesoptional fielddefault value: 0maximum value: 2000000if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages","type":["integer","null"]},"order_by":{"description":"results sorting rulesoptional fieldyou can use the same values as in the filters array to sort the resultspossible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending orderyou should use a comma to set up a sorting typeexample:[\"meta.external_links_count,desc\"]note that you can set no more than three sorting rules in a single requestyou should use a comma to separate several sorting rulesexample:[\"page_timing.dom_complete,asc\",\"size,desc\"]","items":{"type":"string"},"type":["array","null"]},"search_after_token":{"description":"token for subsequent requestsoptional fieldprovided in the identical filed of the response to each request;use this parameter to avoid timeouts while trying to obtain over 20,000 results in a single request;by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request","type":["string","null"]},"tag":{"description":"user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageRawHtmlRequestInfo":{"properties":{"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"url":{"description":"page url
required field
the absolute URL of a page to request HTML
Note: this field is optional if the task was set using the Instant Pages endpoint","type":"string"}},"type":"object"},"Provider0A3E90081762_OnPageRedirectChainsRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can use only one filtering parameter with this endpointis_redirect_loop
the following operators are supported:regex, not_regex, =, <>[\"is_redirect_loop\",\"=\",\"true\"][\"is_redirect_loop\",\"<>\",\"false\"]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned redirect chains
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned redirect chains
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten redirect chains in the results array will be omitted and the data will be provided for the successive redirect chains","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"page URL
optional field
absolute URL of the target page
if you use this field, the API response will return only redirect chains which contain the specified URL","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageResourcesRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"resource_type\",\"=\",\"stylesheet\"][[\"resource_type\",\"=\",\"image\"],
\"and\",[\"checks.is_https\",\"=\",false]][[\"fetch_timing.duration_time\",\">\",1],\"and\",[[\"total_transfer_size\",\">\",100],\"or\",[\"checks.high_loading_time\",\"=\",true]]]
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned resources
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned resources
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten resources in the results array will be omitted and the data will be provided for the successive resources","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"size,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"size,desc\",\"fetch_timing.fetch_end,desc\"]","items":{"type":"string"},"type":["array","null"]},"relevant_pages_filters":{"description":"filter the resources by relevant pages
optional field
you can use this field to obtain resources from pages matching to the defined parameters
you can apply the same filters here as available for the pages endpoint
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"checks.no_image_title\",\"=\",true]","items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["array","null"]},"search_after_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 20,000 results in a single request;
by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;
Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"page URL
optional field
specify this field if you want to get the resources for a specific page
note that to obtain resource's meta from a particular URL, you should specify the URL in this field;
if you do not indicate a url when setting a task, resource's meta in the results will be returned based on the data from the page where our crawler first saw the resource","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_OnPageTaskPostRequestInfo":{"properties":{"accept_language":{"description":"language header for accessing the website
optional field
all locale formats are supported (xx, xx-XX, xxx-XX, etc.)
Note: if you do not specify this parameter, some websites may deny access; in this case, pages will be returned with the \"type\":\"broken in the response array","type":["string","null"]},"allow_subdomains":{"description":"include pages on subdomains
optional field
set to true if you want to crawl all subdomains of a target website
default value: false","type":["boolean","null"]},"allowed_subdomains":{"description":"subdomains to crawl
optional field
specify subdomains that you want to crawl
example: [\"blog.site.com\", \"my.site.com\", \"shop.site.com\"]
Note: to use this parameter, the allow_subdomains parameter should be set to false;
otherwise, the content of allowed_subdomains field will be ignored and the results will be returned for all subdomains","items":{"type":"string"},"type":["array","null"]},"browser_preset":{"description":"preset for browser screen parameters
optional field
if you use this field, you don't need to indicate browser_screen_width, browser_screen_height, browser_screen_scale_factorpossible values:desktop, mobile, tabletdesktop preset will apply the following values:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobile preset will apply the following values:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tablet preset will apply the following values:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2
Note: to use this parameter, set enable_javascript or enable_browser_rendering to true","type":["string","null"]},"browser_screen_height":{"description":"browser screen height
optional field
you can set a custom browser screen height to perform an audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;
Note: to use this parameter, set enable_javascript or enable_browser_rendering to trueminimum value, in pixels: 240
maximum value, in pixels: 9999","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser screen scale factor
optional field
you can set a custom browser screen resolution ratio to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;
Note: to use this parameter, set enable_javascript or enable_browser_rendering to trueminimum value: 0.5
maximum value: 3","type":["number","null"]},"browser_screen_width":{"description":"browser screen width
optional field
you can set a custom browser screen width to perform audit for a particular device;
if you use this field, you don't need to indicate browser_preset as it will be ignored;
Note: to use this parameter, set enable_javascript or enable_browser_rendering to trueminimum value, in pixels: 240
maximum value, in pixels: 9999","format":"int64","type":["integer","null"]},"calculate_keyword_density":{"description":"calculate keyword density for the target domain
optional field
set to true if you want to calculate keyword density for website pages
default value: false
Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article
once the crawl is completed, you can obtain keyword density values with the Keyword Density endpoint","type":["boolean","null"]},"check_spell":{"description":"check spelling
optional field
set to true to check spelling on a website using Hunspell library
default value: false","type":["boolean","null"]},"check_spell_exceptions":{"description":"words excluded from spell check
optional field
specify the words that you want to exclude from spell check
maximum word length: 100 characters
maximum amount of words: 1000
example: \"SERP\", \"minifiers\", \"JavaScript\"","items":{"type":"string"},"type":["array","null"]},"check_spell_language":{"description":"language of the spell check
optional field
supported languages: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
Note: if no language is specified, it will be set automatically based on page content","type":["string","null"]},"checks_threshold":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"custom threshold values for checks
optional field
you can specify custom threshold values for the parameters included in the checks object of OnPage API responses;
Note: only integer threshold values can be modified;
for example, the high_loading_time and large_page_size parameters are set to 3 seconds and 1 megabyte respectively by default;
if you want to change these thresholds to 1 second and 1000 kbytes, use the following snippet:
`\"checks_threshold\": {
\"high_loading_time\": 1,
\"large_page_size\": 1000
}`
available customizable parameters with default values:
`\"title_too_short\", default value: 30, type: \"int\"
\"title_too_long\", default value: 65, type: \"int\"
\"small_page_size\", default value: 1024, type: \"int\"
\"large_page_size\", default value: 1048576 (1024 * 1024), type: \"int\"
\"low_character_count\", default value: 1024, type: \"int\"
\"high_character_count\", default value: 256000 (250 * 1024), type: \"int\"
\"low_content_rate\", default value: 0.1, type: \"float\"
\"high_content_rate\", default value: 0.9, type: \"float\"
\"high_loading_time\", default value: 3000, type: \"int\"
\"high_waiting_time\", default value: 1500, type: \"int\"
\"low_readability_rate\", default value: 15.0, type: \"float\"
\"irrelevant_description\", default value: 0.2, type: \"float\"
\"irrelevant_title\", default value: 0.3, type: \"float\"
\"irrelevant_meta_keywords\", default value: 0.6, type: \"float\"`","type":["object","null"]},"crawl_delay":{"description":"delay between hits, ms
optional field
the custom delay between crawler hits to the server
default value: 2000","type":["integer","null"]},"crawl_sitemap_only":{"description":"crawl only pages indicated in the sitemap
optional field
set to true if you want to crawl only the pages indicated in the sitemap
if you set this parameter to true and do not specify custom_sitemap, we will crawl the default sitemap
default value: false
Note: if you want to use this parameter, respect_sitemap should be true","type":["boolean","null"]},"custom_js":{"description":"custom javascript
optional field
Note that the execution time for the script you enter here should be 700 ms maximum, for example, you can use the following JS snippet to check if the website contains Google Tag Manager as a scr attribute:let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute(\"src\");rn if (src != undefined) {rn if (src.indexOf(\"analytics.js\") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf(\"gtm.js\") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;the returned value depends on what you specified in this field. For instance, if you specify the following script:
`meta = {}; meta.url = document.URL; meta.test = 'test'; meta;`
as a response you will receive the following data:
`\"custom_js_response\": {
\"url\": \"https://dataforseo.com/\",
\"test\": \"test\"
}`
Note: the length of the script you enter must be no more than 2000 characters","type":["string","null"]},"custom_robots_txt":{"description":"custom robots.txt settings
optional field
example: Disallow: /directory1/","type":["string","null"]},"custom_sitemap":{"description":"custom sitemap url
optional field
the URL of the page where the alternative sitemap is located
Note: if you want to use this parameter, respect_sitemap should be true","type":["string","null"]},"custom_user_agent":{"description":"custom user agent
optional field
custom user agent for crawling a website
example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
default value: Mozilla/5.0 (compatible; RSiteAuditor)","type":["string","null"]},"disable_cookie_popup":{"description":"disable the cookie popup
optional field
set to true if you want to disable the popup requesting cookie consent from the user;
default value:false","type":["boolean","null"]},"disable_page_checks":{"description":"prevent certain page checks from running
optional field
specify certain checks to prevent them from running and impacting the onpage_scoreexample:\"disable_page_checks\": [\"is_5xx_code\", \"is_4xx_code\"]","items":{"type":"string"},"type":["array","null"]},"disable_sitewide_checks":{"description":"prevent certain sitewide checks from running
optional field
specify the following checks to prevent them from running on the target website:\"test_page_not_found\"\"test_canonicalization\"\"test_https_redirect\"\"test_directory_browsing\"example:\"disable_sitewide_checks\": [\"test_directory_browsing\", \"test_page_not_found\"]learn more on our help center","items":{"type":"string"},"type":["array","null"]},"disallowed_subdomains":{"description":"subdomains not to crawl
optional field
specify subdomains that you don't want to crawl
example: [\"status.site.com\", \"docs.site.com\"]
Note: to use this parameter, the allow_subdomains parameter should be set to true","items":{"type":"string"},"type":["array","null"]},"enable_browser_rendering":{"description":"emulate browser rendering to measure Core Web Vitals
optional field
by using this parameter you will be able to emulate a browser when loading a web page;enable_browser_rendering loads styles, images, fonts, animations, videos, and other resources on a page;
default value: false
set to true to obtain Core Web Vitals (FID, CLS, LCP) metrics in the response;
if you use this field, enable_javascript, and load_resources parameters must be set to true
Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"enable_content_parsing":{"description":"parse content on crawled pages
optional field
set to true to use the OnPage Content Parsing endpoint
default value: false","type":["boolean","null"]},"enable_javascript":{"description":"load javascript on a page
optional field
set to true if you want to load the scripts available on a page
default value: false
Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"enable_www_redirect_check":{"description":"check if the domain implemented the www redirection
optional field
set to true if you want to check if the requested domain implemented the www to non-www or non-www to www redirect;
default value: false","type":["boolean","null"]},"enable_xhr":{"description":"enable XMLHttpRequest on a page
optional field
set to true if you want our crawler to request data from a web server using the XMLHttpRequest object
default value: false;if you use this field, enable_javascript must be set to true;","type":["boolean","null"]},"force_sitewide_checks":{"description":"enable sitewide checks when crawling a single page
optional field
set to true to get data on sitewide checks when crawling a single page;
default value: false","type":["boolean","null"]},"load_resources":{"description":"load resources
optional field
set to true if you want to load image, stylesheets, scripts, and broken resources
default value: false
Note: if you use this parameter, additional charges will apply; learn more about the cost of tasks with this parameter in our help article; the cost can be calculated on the Pricing Page","type":["boolean","null"]},"max_crawl_depth":{"description":"crawl depth
optional field
the linking depth of the pages to crawl;
for example, starting page of the crawl is level 0, pages that have links from that page are level 1, etc.","type":["integer","null"]},"max_crawl_pages":{"description":"crawled pages limit
required field
the number of pages to crawl on the specified domain
Note:
if you set max_crawl_pages to 1 and do not specify start_url or set a homepage in it, the following sitewide checks will be disabled:test_canonicalization, enable_www_redirect_check, test_hidden_server_signature, test_page_not_found, test_directory_browsing, test_https_redirect
to enable them anyway, set force_sitewide_checks to trueif you set max_crawl_pages to 1 and specify start_url other than a homepage, all sitewide checks will be disabled;
to enable them anyway, set force_sitewide_checks to true","type":"integer"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
URLs specified in this array will be crawled in the first instance, bypassing the crawling queue;
Note: you should specify the absolute URL;
you can specify up to 20 URLs;
all URLs in the array must belong to the target domain;
subdomains will be ignored unless the allow_subdomains parameter is set to trueexample:
`\"priority_urls\": [
\"https://dataforseo.com/apis/serp-api\",
\"https://dataforseo.com/contact\"
]`","items":{"type":"string"},"type":["array","null"]},"respect_sitemap":{"description":"respect sitemap when crawling
optional field
set to true if you want to follow the order of pages indicated in the primary sitemap when crawling;
default value: false
Note: if set to true, the click_depth value in the API response will equal 0;
the max_crawl_depth field of the request will be ignored, you can specify the number of pages to crawl using the max_crawl_pages parameter","type":["boolean","null"]},"return_despite_timeout":{"description":"return data on pages despite the timeout error
optional field
if true, the data will be provided on pages that failed to load within 120 seconds and responded with a timeout error;
default value: false","type":["boolean","null"]},"robots_txt_merge_mode":{"description":"merge with or override robots.txt settings
optional field
possible values: merge, override;
set to override if you want to ignore website crawling restrictions and other robots.txt settings
default value: merge;
Note: if set to override, specify the custom_robots_txt parameter","type":["string","null"]},"start_url":{"description":"the first url to crawl
optional field
Note: you should specify an absolute URL
if you want to crawl a single page, specify its URL in this field and additionally set the max_crawl_pages parameter to 1
you can also use the live Instant Pages endpoint to get page-specific data","type":["string","null"]},"store_raw_html":{"description":"store HTML of crawled pages
optional field
set to true if you want to get the HTML of the page using the OnPage Raw HTML endpoint
default value: false","type":["boolean","null"]},"support_cookies":{"description":"support cookies on crawled pages
optional field
set to true to support cookies when crawling the pages
default value: false","type":["boolean","null"]},"switch_pool":{"description":"switch proxy pool
optional field
if true, additional proxy pools will be used to obtain the requested data;
the parameter can be used if a multitude of tasks is set simultaneously, resulting in occasional rate-limit and/or site_unreachable errors","type":["boolean","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"target domain
required field
domain name should be specified without https:// and www.
if you specify the page URL, the results will be returned for the domain included in the URL","type":"string"},"validate_micromarkup":{"description":"enable microdata validation
optional field
set to true if you want to use the OnPage API Microdata endpoint
default value: false","type":["boolean","null"]}},"type":"object"},"Provider0A3E90081762_OnPageUncrawlableResourcesRequestInfo":{"properties":{"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example: [[\"meta.content_type\",\"=\",\"image/jpeg\"],
\"and\",
[\"url\",\"not_like\",\"%/help-center/%\"]]
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"limit":{"description":"the maximum number of returned uncrawlable resources
optional field
default value: 100
maximum value: 1000","type":["integer","null"]},"offset":{"description":"offset in the results array of returned uncrawlable resources
optional field
default value: 0
maximum value: 2000000
if you specify the 10 value, the first ten invalid resources in the results array will be omitted and the data will be provided for the successive invalid resources","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"meta.content_type,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:[\"meta.content_type,asc\",\"fetch_time,desc\"]","items":{"type":"string"},"type":["array","null"]}},"type":"object"},"Provider0A3E90081762_OnPageWaterfallRequestInfo":{"properties":{"id":{"description":"ID of the task
required field
you can get this ID in the response of the Task POST endpoint
example:
\"07131248-1535-0216-1000-17384017ad04\"","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"page URL
required field
specify the pages you want to receive timing for","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpAiSummaryRequestInfo":{"properties":{"fetch_content":{"description":"fetch content from pages in SERPs
optional field
if set to true, the API will fetch the content from pages featured in SERP results, and the AI model will consider this content when generating the summary in the result;
default value: false","type":["boolean","null"]},"include_links":{"description":"include source links in the summary
optional field
if set to true, the summary field in the API response will contain links to sources of the generated summary;
default value: false","type":["boolean","null"]},"prompt":{"description":"AI prompt
optional field
additional task for AI summariser;
any form of text, question or information that communicates to AI what response you're looking for;
max number of symbols or characters you can specify: 2000;
note: your prompt has to be relevant to the keyword specified in the POST request to SERP API","type":["string","null"]},"support_extra":{"description":"support extra SERP features
optional field
if set to true, the AI model will consider the following extra SERP features, in addition to organic results: answer_box, knowledge_graph, featured_snippet;
default value: true","type":["boolean","null"]},"task_id":{"description":"task identifier
required field
unique identifier of the associated task in the UUID format
you will be able to use it within 30 days to request the results of the task at any time","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo":{"properties":{"match_type":{"description":"target match type\nrequired field if stop_crawl_on_match is specified;\ntype of match for the match_value\npossible values: domain, with_subdomains, wildcard","type":["string","null"]},"match_value":{"description":"arget domain or wildcard value\nrequired field if stop_crawl_on_match is specified;\nspecify a target domain or wildcard value;\nNote: domain name must be specified without a request protocol;\nexample: dataforseo.com","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpBaiduOrganicTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 10
max value: 700
Your account will be billed per each SERP containing up to 10 results;
Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
return results for a specific device type
can take the values: desktop, mobile, tablet
default value: desktop","type":["string","null"]},"get_website_url":{"description":"include direct URL for each ranked result
optional field
if set to true, the returned results will contain direct URLs of the ranked websites
by default, the URLs in Baidu results are encoded by the search engine,
for example:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLdefault value: false
Note: if set to true, the charge per task will be multiplied by 10 as our system runs a separate request for each ranked website to return its direct URL","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesnote that the only language supported in Baidu search engine is Chinese (Simplified) with the zh_CN language code. However, Baidu may as well return results for queries in other languages, so specifying keyword in Chinese is not mandatoryzh_CN","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesnote that the only language supported in Baidu search engine is Chinese (Simplified). However, Baidu may as well return results for queries in other languages, so specifying keyword in Chinese is not mandatoryChinese (Simplified)","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2156","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)if you use this field, the returned results will be based on the closest city found for your coordinates. Thus, we don't recommend using this field as the results might not be relevant to the specified coordinates
example:53.476225,-2.243572,200","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:New York,New York,United States","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 100
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android
if you specify tablet in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:regular, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priority
You will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpBingOrganicLiveAdvancedRequestInfo":{"properties":{"browser_screen_height":{"description":"240-9999;1080 for desktop;640 for mobile on android;812 for mobile on iOS;calculate_rectangles to true0.5-3;1 for desktop;3 for mobile on android;3 for mobile on iOS;calculate_rectangles to true240-9999;1920 for desktop;360 for mobile on android;375 for mobile on iOS;calculate_rectangles to truefalse10200
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopkeyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format53.476225,-2.243572location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"1100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidtag value in the data object of the responsehttps:// and www.target-specific tasks will only include SERP elements that contain a url string;example.com - returns results for the website's home page with URLs, such as https://example.com, or https://www.example.com/, or https://example.com/;example.com* - returns results for the domain, including all its pages;*example.com* - returns results for the entire domain, including all its pages and subdomains;*example.com - returns results for the home page regardless of the subdomain, such as https://en.example.com;example.com/example-page - returns results for the exact URL;example.com/example-page* - returns results for all domain's URLs that start with the specified stringhttps://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE10200
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopkeyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format53.476225,-2.243572location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"1100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidtag value in the data object of the responsehttps://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE10200
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopkeyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format53.476225,-2.243572location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"1100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidtag value in the data object of the responsehttps:// and www.target-specific tasks will only include SERP elements that contain a url string;example.com - returns results for the website's home page with URLs, such as https://example.com, or https://www.example.com/, or https://example.com/;example.com* - returns results for the domain, including all its pages;*example.com* - returns results for the entire domain, including all its pages and subdomains;*example.com - returns results for the home page regardless of the subdomain, such as https://en.example.com;example.com/example-page - returns results for the exact URL;example.com/example-page* - returns results for all domain's URLs that start with the specified stringhttps://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE240-9999;1080 for desktop;640 for mobile on android;812 for mobile on iOS;calculate_rectangles to true0.5-3;1 for desktop;3 for mobile on android;3 for mobile on iOS;calculate_rectangles to true240-9999;1920 for desktop;360 for mobile on android;375 for mobile on iOS;calculate_rectangles to truefalse10700
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopkeyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude\" format53.476225,-2.243572location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"1100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroid$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urlregular, advanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responsehttps://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGEkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center articlelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations2840location_name, location_code, or location_coordinate, advertisers will be searched across all the available locationslocation_name or location_code52.6178549,-155.352142location_name, location_code, or location_coordinate, advertisers will be searched across all the available locationslocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/ads_advertisers/locationsLondon,England,United Kingdomlocation_name, location_code, or location_coordinate, advertisers will be searched across all the available locations$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvancedgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responsetarget is not specifiedadvertiser_ids values for this parameter can be found in the Google Ads Advertisers endpoint;date_to is specified; \"yyyy-mm-dd\"\"2020-01-01\"date_from is specified; \"yyyy-mm-dd\"\"2020-01-01\"40700
Your account will be billed per each SERP containing up to 40 results;all, text, image, videolocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/ads_search/locations2840location_name, location_code, or location_coordinate, the ads will be searched across all the available locationslocation_name or location_code52.6178549,-155.352142location_name, location_code, or location_coordinate, the ads will be searched across all the available locationslocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/ads_search/locationsLondon,England,United Kingdomlocation_name, location_code, or location_coordinate, the ads will be searched across all the available locations$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23all, google_play, google_maps, google_search, google_shopping, youtubeallpostback_urladvancedgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responseadvertiser_ids is not specified240-9999;1080 for desktop;640 for mobile on android;812 for mobile on iOS;calculate_rectangles to true0.5-3;1 for desktop;3 for mobile on android;3 for mobile on iOS;calculate_rectangles to true240-9999;1920 for desktop;360 for mobile on android;375 for mobile on iOS;calculate_rectangles to truefalsetrue, the charge per task will be multiplied by 2desktop, mobiledesktopkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_name;language_name;language_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/ai_mode/languageslanguage_code;language_code;language_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/ai_mode/languages;location_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationslocation_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,18zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsdesktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidtag value in the data object of the response
optional field
return results for a specific device type
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character '+' will be decoded to a space character)
if you need to use the \"%\" character for your keyword, please specify it as \"%25\";
if you need to use the “+” character for your keyword, please specify it as “%2B”;","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/google/ai_mode/languagesn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/ai_mode/languages;","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:London,England,United Kingdom","type":"string"},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpGoogleAiModeTaskPostRequestInfo":{"properties":{"browser_screen_height":{"description":"240-9999;1080 for desktop;640 for mobile on android;812 for mobile on iOS;calculate_rectangles to true0.5-3;1 for desktop;3 for mobile on android;3 for mobile on iOS;calculate_rectangles to true240-9999;1920 for desktop;360 for mobile on android;375 for mobile on iOS;calculate_rectangles to truefalsetrue, the charge per task will be multiplied by 2desktop, mobiledesktopkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_name;language_name;language_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/ai_mode/languageslanguage_code;language_code;language_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/ai_mode/languages;location_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationslocation_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,18zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsdesktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroid$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responsechrome — used when google search is opened in google chrome;chrome-omni — used in the address bar in chrome;gws-wiz — used in google search home page;gws-wiz-serp — used in google search engine results page;safari — used when google search is opened in safari browser;firefox — used when google search is opened in firefox browser;psy-ab — may be used when google search is opened in google chrome browser;toolbar — returns XML;youtube — returns JSONP;gws-wiz-local — used in google local;img — used in google's image search;products-cc — used in google shopping search0keyword|which query are s - \"cursor_pointer\": 0which query is s| - \"cursor_pointer\": 16which que|ry is s - \"cursor_pointer\": 9keyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_name;language_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_code;language_name by making a separate request to https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name;location_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_code;location_name by making a separate request to https://api.dataforseo.com/v3/serp/google/autocomplete/locationsLondon,England,United Kingdomtag value in the data object of the responsechrome — used when google search is opened in google chrome;chrome-omni — used in the address bar in chrome;gws-wiz — used in google search home page;gws-wiz-serp — used in google search engine results page;safari — used when google search is opened in safari browser;firefox — used when google search is opened in firefox browser;psy-ab — may be used when google search is opened in google chrome browser;toolbar — returns XML;youtube — returns JSONP;gws-wiz-local — used in google local;img — used in google's image search;products-cc — used in google shopping search0keyword|which query are s - \"cursor_pointer\": 0which query is s| - \"cursor_pointer\": 16which que|ry is s - \"cursor_pointer\": 9keyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_name;language_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_code;language_name by making a separate request to https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name;location_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_code;location_name by making a separate request to https://api.dataforseo.com/v3/serp/google/autocomplete/locationsLondon,England,United Kingdom$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvancedgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be url-encoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority;tag value in the data object of the responsedataset item of Google Dataset Search resultL2cvMTFqbl85ZHN6MQ==desktoplanguage_nameenlanguage_codeEnglishwindows, macoswindowstag value in the data object of the responsedataset item of Google Dataset Search resultL2cvMTFqbl85ZHN6MQ==desktoplanguage_nameenlanguage_codeEnglishwindows, macoswindows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvancedgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the response20200
Your account will be billed per each SERP containing up to 20 results;desktopother, archive, text, image, document, tabulartrue, falsekeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_nameenlanguage_codeEnglish1m, 1y, 3ywindows, macoswindowstag value in the data object of the responsehumanities, social_sciences, life_sciences, agriculture, natural_sciences, geo, computer, architecture_and_urban_planning, engineeringcommercial, noncommercial20700
Your account will be billed per each SERP containing up to 20 results;desktopother, archive, text, image, document, tabulartrue, falsekeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”.keyword and keywords fields in DataForSEO APIs in this Help Center articleenlanguage_codeEnglish1m, 1y, 3ywindows, macoswindows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvancedgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responsehumanities, social_sciences, life_sciences, agriculture, natural_sciences, geo, computer, architecture_and_urban_planning, engineeringcommercial, noncommercialdesktoplanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomtop_stories, local_market, world_marketstop_storieslocal_market or world_markets, the charge per task will be multiplied by 2windowstag value in the data object of the responsedesktoplanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomtop_stories, local_market, world_marketstop_storieswindowstag value in the data object of the responsedesktoplanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomtop_stories, local_market, world_marketstop_storieslocal_market or world_markets, the charge per task will be multiplied by 2windows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority;tag value in the data object of the responsedesktoplanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdommost-active, indexes, indexes/americas, indexes/europe-middle-east-africa, indexes/asia-pacific, gainers, losers, climate-leaders, cryptocurrencies, currenciesmost-activewindowstag value in the data object of the responsedesktoplanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdommost-active, indexes, indexes/americas, indexes/europe-middle-east-africa, indexes/asia-pacific, gainers, losers, climate-leaders, cryptocurrencies, currenciesmost-activewindowstag value in the data object of the responsedesktoplanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdommost-active, indexes, indexes/americas, indexes/europe-middle-east-africa, indexes/asia-pacific, gainers, losers, climate-leaders, cryptocurrencies, currenciesmost-activewindows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority;tag value in the data object of the responsedesktopkeyword field;keyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomwindowstag value in the data object of the responsegoogle_finance_quote graph1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX1D1D, the charge per task will be multiplied by 2desktopkeyword field;keyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomwindowstag value in the data object of the responsegoogle_finance_quote graph1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX1Ddesktopkeyword field;keyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomwindows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority;tag value in the data object of the responsegoogle_finance_quote graph1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX1D1D, the charge per task will be multiplied by 2all, stock, index, mutual_fund, currency, futuresallkeyword field;keyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomtag value in the data object of the responseall, stock, index, mutual_fund, currency, futuresallkeyword field;keyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_code language_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_namelocation_namelocation_code by making a separate request to https://api.dataforseo.com/v3/serp/google/locations2840location_codelocation_codelocation_name by making a separate request to https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdom$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority;tag value in the data object of the response100200
Your account will be billed per each SERP containing up to 100 results;keyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;windows, macoswindowstag value in the data object of the responsehttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS100200
Your account will be billed per each SERP containing up to 100 results;keyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;windows, macoswindowstag value in the data object of the responsehttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS100700
Your account will be billed per each SERP containing up to 100 results;keyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;windows, macoswindows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responsehttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS10200
Your account will be billed per each SERP containing up to 10 results;fulltime, partime, contractor, internkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;.net developerkeyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_name;language_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_code;language_name by making a separate request to https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name;location_code by making a separate request to https://api.dataforseo.com/v3/serp/google/jobs/locations2840location_codelocation_code;location_name by making a separate request to https://api.dataforseo.com/v3/serp/google/jobs/locationsLondon,England,United Kingdom1.609;300> 0$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urlregular, advanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority;tag value in the data object of the response10100
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesenlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,20zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomdesktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroid
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the response10100
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”language_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesenlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,20zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomdesktop: 3.5, 4, 4.5;mobile: 2, 2.5, 3, 3.5, 4, 4.5desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidtag value in the data object of the response\"open_now\", \"24_hours\", \"$day_value\", \"$day_value;$time_value\";$day_value use one of these values: \"monday\", \"tuesday\", \"wednesday\", \"thursday\", \"friday\", \"saturday\", \"sunday\";$time_value use one of these values: \"00\", \"01\", \"02\", \"03\", \"04\", \"05\", \"06\", \"07\", \"08\", \"09\", \"10\", \"11\", \"12\", \"13\", \"14\", \"15\", \"16\", \"17\", \"18\", \"19\", \"20\", \"21\", \"22\", \"23\"\"tuesday;18\"10350
your account will be billed per each SERP containing up to 10 results;
setting depth above 10 may result in additional charges if the search engine returns more than 10 results respectively;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"desktop, mobiledesktopkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesenlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,18zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdomdesktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroid$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the response100700
Your account will be billed per each SERP containing up to 100 results;desktop, mobiledesktopmobile device, only 20 results are returned for every SERPkeyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,20zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidgoogle.co.uk, google.com.au, google.de, etc.false;truesearch_places mode is turned off and no results were found in the search area, the results array will be emptytrue, falsetruefalse, the search_this_area mode will be turned offsearch_this_area mode is turned off, Google Maps listings might contain results beyond the displayed areatag value in the data object of the responsehttps://google.com/maps/search/pizza/@37.09024,-95.712891,4z
Note: the following search engine parameters are not supported and will be automatically unset if specified in the URL: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpGoogleMapsTaskPostRequestInfo":{"properties":{"depth":{"description":"100700
Your account will be billed per each SERP containing up to 100 results;desktop, mobiledesktopmobile device, only 20 results are returned for every SERPkeyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,zoom\" format52.6178549,-155.352142,20zlocation_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroid$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvancedgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.google.co.ukfalse;default value: truesearch_places mode is turned off and no results were found in the search area, the results array will be emptytrue, falsetruefalse, the search_this_area mode will be turned offsearch_this_area mode is turned off, Google Maps listings might contain results beyond the displayed areatag value in the data object of the responsehttps://google.com/maps/search/pizza/@37.09024,-95.712891,4z
Note: the following search engine parameters are not supported and will be automatically unset if specified in the URL: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpGoogleNewsLiveAdvancedRequestInfo":{"properties":{"browser_screen_height":{"description":"1080;calculate_rectangles to true1;calculate_rectangles to true1920;calculate_rectangles to truefalsetrue, the charge per task will be multiplied by 210200
Your account will be billed per each SERP containing up to 10 results;keyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;windows, macoswindowsgoogle.co.uk, google.com.au, google.de, etc.https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS10200
Your account will be billed per each SERP containing up to 10 results;keyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;windows, macoswindowsgoogle.co.uk, google.com.au, google.de, etc.tag value in the data object of the responsehttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS1080;calculate_rectangles to true1;calculate_rectangles to true1920;calculate_rectangles to truefalsetrue, the charge per task will be multiplied by 210700
Your account will be billed per each SERP containing up to 10 results;keyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;windows, macoswindows$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.tag value in the data object of the responsehttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS10200
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktoptrue to expand the ai_overview item;falsestop_crawl_on_match must also be enabledurl and domain fields are checked for targetsorganic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitterignore_targets_in\"find_targets_in\": [\"organic\", \"featured_snippet\"]stop_crawl_on_match must also be enabledorganic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitterfind_targets_in\"ignore_targets_in\": [\"paid\", \"images\"]keyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;language_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishtrue to obtain ai_overview items is SERPs even if they are loaded asynchronously;false, you will only obtain ai_overview items from cache;false\"asynchronous_ai_overview\": false, all extra charges will be returned to your account balancelocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidgoogle.co.uk, google.com.au, google.de, etc.
Note: the following search engine parameters are not supported and will be automatically unset if specified: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"tag value in the data object of the responsestop_crawl_on_match must also be enabledstop_crawl_on_matchall, anyall – the crawl stops only when all specified targets are foundany – the crawl stops when any single target is foundanyhttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
Note: the following search engine parameters are not supported and will be automatically unset if specified in the URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpGoogleOrganicLiveRegularRequestInfo":{"properties":{"depth":{"description":"10200
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktopstop_crawl_on_match must also be enabledurl and domain fields are checked for targetsorganic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitterignore_targets_in\"find_targets_in\": [\"organic\", \"featured_snippet\"]true, the related_result element in the response will be provided as a snippet of its parent organic result;false, the related_result element will be provided as a separate organic result;truestop_crawl_on_match must also be enabledorganic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitterfind_targets_in\"ignore_targets_in\": [\"paid\", \"images\"]keyword fieldkeyword, please specify it as \"%25\";keyword, please specify it as “%2B”;language_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidgoogle.co.uk, google.com.au, google.de, etc.
Note: the following search engine parameters are not supported and will be automatically unset if specified: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"tag value in the data object of the responsehttps:// and www.target-specific tasks will only include SERP elements that contain a url string;example.com - returns results for the website's home page with URLs, such as https://example.com, or https://www.example.com/, or https://example.com/;example.com* - returns results for the domain, including all its pages;*example.com* - returns results for the entire domain, including all its pages and subdomains;*example.com - returns results for the home page regardless of the subdomain, such as https://en.example.com;example.com/example-page - returns results for the exact URL;example.com/example-page* - returns results for all domain's URLs that start with the specified stringstop_crawl_on_match must also be enabledstop_crawl_on_matchall, anyall – the crawl stops only when all specified targets are foundany – the crawl stops when any single target is foundanyhttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
Note: the following search engine parameters are not supported and will be automatically unset if specified in the URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpGoogleOrganicTaskPostRequestInfo":{"properties":{"browser_screen_height":{"description":"240-9999;1080 for desktop;640 for mobile on android;812 for mobile on iOS;calculate_rectangles to true0.5-3;1 for desktop;3 for mobile on android;3 for mobile on iOS;calculate_rectangles to true240-9999;1920 for desktop;360 for mobile on android;375 for mobile on iOS;calculate_rectangles to truefalse10700
Your account will be billed per each SERP containing up to 10 results;desktop, mobiledesktoptrue to expand the ai_overview item;false;stop_crawl_on_match must also be enabledurl and domain fields are checked for targetsorganic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitterignore_targets_in\"find_targets_in\": [\"organic\", \"featured_snippet\"]true, the related_result element in the response will be provided as a snippet of its parent organic result;false, the related_result element will be provided as a separate organic result;truestop_crawl_on_match must also be enabledorganic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitterfind_targets_in\"ignore_targets_in\": [\"paid\", \"images\"]keyword fieldkeyword, please specify it as “%25”;keyword, please specify it as “%2B”;keyword and keywords fields in DataForSEO APIs in this Help Center articlelanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/languagesEnglishtrue to obtain ai_overview items is SERPs even if they are loaded asynchronously;false, you will only obtain ai_overview items from cache;false\"asynchronous_ai_overview\": false, all extra charges will be returned to your account balancelocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/locationsLondon,England,United Kingdomstop_crawl_on_match is specifiedmatch_valuedomain – specific domain or subdomainwith_subdomains – main domain and subdomainswildcard – wildcard patternstop_crawl_on_match is specified\"match_value\": \"dataforseo.com\",\"match_value\": \"/blog/post-*\"100max_crawl_pages and depth parameters complement each other;desktop in the device field, choose from the following values: windows, macoswindowsmobile in the device field, choose from the following values: android, iosandroidpeople_also_ask element to get additional people_also_ask_element items;1 to 4$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urlregular, advanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the requesthttp://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.\"remove_from_url\": [\"srsltid\"]google.co.uk, google.com.au, google.de, etc.
Note: the following search engine parameters are not supported and will be automatically unset if specified: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"tag value in the data object of the responsestop_crawl_on_match must also be enabledstop_crawl_on_matchall, anyall – the crawl stops only when all specified targets are foundany – the crawl stops when any single target is foundanyhttps://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
Note: the following search engine parameters are not supported and will be automatically unset if specified in the URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpGoogleSearchByImageTaskPostRequestInfo":{"properties":{"browser_screen_height":{"description":"1080;calculate_rectangles to true1;calculate_rectangles to true1920;calculate_rectangles to truefalsetrue, the charge per task will be multiplied by 2https://upload.wikimedia.org/wikipedia/commons/e/ed/Elon_Musk_Royal_Society.jpglanguage_namelanguage_namelanguage_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesexample:enlanguage_codelanguage_codelanguage_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesEnglishlocation_name or location_coordinatelocation_name or location_coordinatelocation_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations2840location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200location_code or location_coordinatelocation_code or location_coordinatelocation_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsLondon,England,United Kingdom100max_crawl_pages and depth parameters complement each other;$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url will be urlencoded;# character will be encoded into %23postback_urladvanced, htmlgzip format to the postback_url you specified$id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url will be urlencoded;# character will be encoded into %23
You will be additionally charged for the tasks with high execution priority.google.co.uk, google.com.au, google.de, etc.tag value in the data object of the response
optional field
number of results in SERP
default value: 15
max value: 700
Your account will be billed per each SERP containing up to 15 results;
Setting depth above 15 may result in additional charges if the search engine returns more than 15 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
return results for a specific device type
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 100
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the function you used for setting a task
possible values:regular, advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically
however, you can set a custom search engine domain in this field
example:
optional field
get the list of available parameters and additional details here","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields
in most cases, we wouldn’t recommend using this method;
example:https://search.naver.com/search.naver?where=nexearch&sm=top_hty&fbm=1&ie=utf8&query=iphone","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpScreenshotRequestInfo":{"properties":{"browser_preset":{"description":"browser resolution preset
optional field
browser preset associated with a certain device type
can take the following values: desktop, tablet, mobile
Note: by default, browser preset corresponds to the device type specified in the POST request","type":["string","null"]},"browser_screen_height":{"description":"height of the browser resolution
optional field
can be specified in the following range: 240-9999
default value for desktop: 1080
default value for mobile: 844
default value for table: 1366","type":["integer","null"]},"browser_screen_scale_factor":{"description":"browser scale factor
optional field
can be specified in the following range: 0.5-3
default value for desktop: 1
default value for mobile: 3
default value for table: 2","type":["number","null"]},"browser_screen_width":{"description":"width of the browser resolution
optional field
can be specified in the following range: 240-9999
default value for desktop: 1920
default value for mobile: 390
default value for table: 1024","format":"int64","type":["integer","null"]},"page":{"description":"number of SERP pages
optional field
if depth in the corresponding Task POST request exceeds 10 results (or 1 SERP page), specify the number of SERP pages to screenshot;
default value: 1","type":["integer","null"]},"task_id":{"description":"task identifier
required field
unique identifier of the associated task in the UUID format
you will be able to use it within 7 days to request the results of the task at any time","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpSeznamOrganicTaskPostRequestInfo":{"properties":{"calculate_rectangles":{"description":"calculate pixel rankings for SERP elements in advanced results
optional field
pixel ranking refers to the distance between the result snippet and top left corner of the screen;
Visit Help Center to learn more>>
by default, the parameter is set to false
Note: if set to true, the charge per task will be multiplied by 2","type":["boolean","null"]},"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 10;
maximum value: 500;
Your account will be billed per each SERP containing up to 10 results;
Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
return results for a specific device type
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:csn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:Czech","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:London,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 10
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the function you used for setting a task
possible values:regular, advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priority
You will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically
however, you can set a custom search engine domain in this field
example:
optional field","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields;
note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL;
in most cases, we wouldn’t recommend using this method.","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYahooOrganicLiveAdvancedRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 6
max value: 200
Your account will be billed per each SERP;
Each Yahoo SERP can contain fewer than 10 results, so setting depth above the default value may result in additional charges ;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
return results for a specific device type
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character '+' will be decoded to a space character)
if you need to use the \"%\" character for your keyword, please specify it as \"%25\";
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:London,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 100
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
get the list of available parameters and additional details here","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"target domain, subdomain, or webpage to get results for
optional field
a domain or a subdomain should be specified without https:// and www.
note that the results of target-specific tasks will only include SERP elements that contain a url string;
you can also use a wildcard (‘*’) character to specify the search pattern in SERP and narrow down the results;
examples:example.com - returns results for the website's home page with URLs, such as https://example.com, or https://www.example.com/, or https://example.com/;example.com* - returns results for the domain, including all its pages;*example.com* - returns results for the entire domain, including all its pages and subdomains;*example.com - returns results for the home page regardless of the subdomain, such as https://en.example.com; example.com/example-page - returns results for the exact URL;example.com/example-page* - returns results for all domain's URLs that start with the specified string","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYahooOrganicLiveHtmlRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 10
max value: 200
Your account will be billed per each SERP containing up to 10 results;
Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
return results for a specific device type
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character '+' will be decoded to a space character)
if you need to use the \"%\" character for your keyword, please specify it as \"%25\";
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:London,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 100
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
get the list of available parameters and additional details here","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYahooOrganicLiveRegularRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 6
max value: 200
Your account will be billed per each SERP;
Each Yahoo SERP can contain fewer than 10 results, so setting depth above the default value may result in additional charges ;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character '+' will be decoded to a space character)
if you need to use the \"%\" character for your keyword, please specify it as \"%25\";
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:London,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 100
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
get the list of available parameters and additional details here","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"target domain, subdomain, or webpage to get results for
optional field
a domain or a subdomain should be specified without https:// and www.
note that the results of target-specific tasks will only include SERP elements that contain a url string;
you can also use a wildcard (‘*’) character to specify the search pattern in SERP and narrow down the results;
examples:example.com - returns results for the website's home page with URLs, such as https://example.com, or https://www.example.com/, or https://example.com/;example.com* - returns results for the domain, including all its pages;*example.com* - returns results for the entire domain, including all its pages and subdomains;*example.com - returns results for the home page regardless of the subdomain, such as https://en.example.com; example.com/example-page - returns results for the exact URL;example.com/example-page* - returns results for all domain's URLs that start with the specified string","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYahooOrganicTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 6
max value: 700
Your account will be billed per each SERP;
Each Yahoo SERP can contain fewer than 10 results, so setting depth above the default value may result in additional charges ;
The cost can be calculated on the Pricing page.","type":["integer","null"]},"device":{"description":"device type
optional field
return results for a specific device type
can take the values:desktop, mobile
default value: desktop","type":["string","null"]},"keyword":{"description":"keyword
required field
you can specify up to 700 characters in the keyword field
all %## will be decoded (plus character '+' will be decoded to a space character)
if you need to use the \"%\" character for your keyword, please specify it as \"%25\";
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:2840n","type":"integer"},"location_coordinate":{"description":"GPS coordinates of a location
required field if you don't specify location_name_or location_code
if you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format
the maximum number of decimal digits for \"latitude\" and \"longitude\": 7
the minimum value for \"radius\": 199.9 (mm)
the maximum value for \"radius\": 199999 (mm)
example:53.476225,-2.243572,200n","type":"string"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
example:London,England,United Kingdom","type":"string"},"max_crawl_pages":{"description":"page crawl limit
optional field
number of search results pages to crawl
default value: 1
max value: 100
Note: the max_crawl_pages and depth parameters complement each other;
learn more at our help center","type":["integer","null"]},"os":{"description":"device operating system
optional field
if you specify desktop in the device field, choose from the following values: windows, macos
default value: windows
if you specify mobile in the device field, choose from the following values: android, ios
default value: android","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the datatype that will be sent to your server
possible values:regular, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"se_domain":{"description":"search engine domain
optional field
we choose the relevant search engine domain automatically according to the location and language you specify
however, you can set a custom search engine domain in this field
example:au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.","type":["string","null"]},"search_param":{"description":"additional parameters of the search query
optional field
get the list of available parameters and additional details here","type":["string","null"]},"stop_crawl_on_match":{"description":"array of targets to stop crawling\noptional field\nif specified, the response will contain SERP results up to and including the specified match_value;\nyou can specify up to 10 target values in this array\nexample:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nlearn more about this parameter on our Help Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nYour account will be billed per each SERP crawled through the specified targets","items":{"oneOf":[{"$ref":"#/components/schemas/Provider0A3E90081762_SerpApiStopCrawlOnMatchInfo"}],"type":["object","null"]},"type":["array","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"url":{"description":"direct URL of the search query
optional field
you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.
example:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYoutubeOrganicLiveAdvancedRequestInfo":{"properties":{"block_depth":{"description":"parsing depth\noptional field\nnumber of blocks of results in SERP\ndefault value: 20\nmax value: 200\nNote: your account will be billed per each SERP containing up to 20 results;\nthus, setting a block depth above 20 may result in additional charges if the search engine returns more than 20 results;\nif the specified block depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance","type":["integer","null"]},"device":{"description":"device type\noptional field\nreturn results for a specific device type\navailable values: desktop, mobile","type":["string","null"]},"keyword":{"description":"keyword\nrequired field\nyou can specify up to 700 characters in the keyword field\nall %## will be decoded (plus character ‘+’ will be decoded to a space character)\nif you need to use the “%” character for your keyword, please specify it as “%25”;\nif you need to use the “+” character for your keyword, please specify it as “%2B”;\nlearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name \nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nif you specify desktop in the device field, choose from the following values: windows, macos\ndefault value: windows\nif you specify mobile in the device field, choose from the following values: android, ios\ndefault value: android","type":["string","null"]},"search_param":{"description":"additional parameters of the search query\noptional field\nexample:\nsp=EgIQAg%253D%253D","type":["string","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYoutubeOrganicTaskPostRequestInfo":{"properties":{"block_depth":{"description":"parsing depth\noptional field\nnumber of blocks of results in SERP\ndefault value: 20\nmax value: 700\nNote: your account will be billed per each SERP containing up to 20 blocks of results;\nthus, setting a block depth above 20 may result in additional charges if the search engine returns more than 20 results;\nif the specified block depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance","type":["integer","null"]},"device":{"description":"device type\noptional field\nreturn results for a specific device type\navailable values: desktop, mobile","type":["string","null"]},"keyword":{"description":"keyword\nrequired field\nyou can specify up to 700 characters in the keyword field\nall %## will be decoded (plus character ‘+’ will be decoded to a space character)\nif you need to use the “%” character for your keyword, please specify it as “%25”;\nif you need to use the “+” character for your keyword, please specify it as “%2B”;\nlearn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name\nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nif you specify desktop in the device field, choose from the following values: windows, macos\ndefault value: windows\nif you specify mobile in the device field, choose from the following values: android, ios\ndefault value: android","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task\noptional field\nwhen a task is completed we will notify you by GET request sent to the URL you have specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/pingscript?id=$id\nhttp://your-server.com/pingscript?id=$id&tag=$tag\nNote: special characters in pingback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype\nrequired field if you specify postback_url\ncorresponds to the datatype that will be sent to your server\npossible value:\nadvanced","type":["string","null"]},"postback_url":{"description":"return URL for sending task results\noptional field\nonce the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/postbackscript?id=$id\nhttp://your-server.com/postbackscript?id=$id&tag=$tag\nNote: special characters in postback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority\noptional field\ncan take the following values:\n1 – normal execution priority (set by default)\n2 – high execution priority\nYou will be additionally charged for the tasks with high execution priority.\nThe cost can be calculated on the Pricing page.","type":["integer","null"]},"search_param":{"description":"additional parameters of the search query\noptional field\nexample:\nsp=EgIQAg%253D%253D","type":["string","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"},"Provider0A3E90081762_SerpYoutubeVideoCommentsLiveAdvancedRequestInfo":{"properties":{"depth":{"description":"parsing depth
optional field
number of results in SERP
default value: 20
max value: 200
Note: your account will be billed per each SERP containing up to 20 results;
thus, setting a depth above 20 may result in additional charges if the search engine returns more than 20 results;
if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance","type":["integer","null"]},"device":{"description":"device type
optional field
only value: desktop","type":["string","null"]},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name_
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations
example:2840n","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations
example:United States","type":"string"},"os":{"type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"video_id":{"description":"ID of the video
required field
you can find video ID in the URL or 'youtube_video' item of YouTube Organic result
example:vQXvyV0zIP4","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpYoutubeVideoCommentsTaskPostRequestInfo":{"properties":{"depth":{"description":"parsing depth\noptional field\nnumber of results in SERP\ndefault value: 20\nmax value: 700\nNote: your account will be billed per each SERP containing up to 20 results;\nthus, setting a depth above 20 may result in additional charges if the search engine returns more than 20 results;\nif the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance","type":["integer","null"]},"device":{"description":"device type\noptional field\nonly value: desktop","type":["string","null"]},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name\nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nchoose from the following values: windows, macos\ndefault value: windows","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task\noptional field\nwhen a task is completed we will notify you by GET request sent to the URL you have specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/pingscript?id=$id\nhttp://your-server.com/pingscript?id=$id&tag=$tag\nNote: special characters in pingback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype\nrequired field if you specify postback_url\ncorresponds to the datatype that will be sent to your server\npossible value:\nadvanced","type":["string","null"]},"postback_url":{"description":"return URL for sending task results\noptional field\nonce the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/postbackscript?id=$id\nhttp://your-server.com/postbackscript?id=$id&tag=$tag\nNote: special characters in postback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority\noptional field\ncan take the following values:\n1 – normal execution priority (set by default)\n2 – high execution priority\nYou will be additionally charged for the tasks with high execution priority.\nThe cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]},"video_id":{"description":"ID of the video\nrequired field\nyou can find video ID in the URL or 'youtube_video' item of YouTube Organic result\nexample:\nvQXvyV0zIP4","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpYoutubeVideoInfoLiveAdvancedRequestInfo":{"properties":{"device":{"description":"device type\noptional field\nonly value: desktop","type":["string","null"]},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name \nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nchoose from the following values: windows, macos\ndefault value: windows","type":["string","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]},"video_id":{"description":"ID of the video\nrequired field\nyou can find video ID in the URL or 'youtube_video' item of YouTube Organic result\nexample:\nvQXvyV0zIP4","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpYoutubeVideoInfoTaskPostRequestInfo":{"properties":{"device":{"description":"device type\noptional field\nonly value: desktop","type":["string","null"]},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name\nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nchoose from the following values: windows, macos\ndefault value: windows","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task\noptional field\nwhen a task is completed we will notify you by GET request sent to the URL you have specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/pingscript?id=$id\nhttp://your-server.com/pingscript?id=$id&tag=$tag\nNote: special characters in pingback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype\nrequired field if you specify postback_url\ncorresponds to the datatype that will be sent to your server\npossible value:\nadvanced","type":["string","null"]},"postback_url":{"description":"return URL for sending task results\noptional field\nonce the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/postbackscript?id=$id\nhttp://your-server.com/postbackscript?id=$id&tag=$tag\nNote: special characters in postback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority\noptional field\ncan take the following values:\n1 – normal execution priority (set by default)\n2 – high execution priority\nYou will be additionally charged for the tasks with high execution priority.\nThe cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]},"video_id":{"description":"ID of the video\nrequired field\nyou can find video ID in the URL or 'youtube_video' item of YouTube Organic result\nexample:\nvQXvyV0zIP4","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpYoutubeVideoSubtitlesLiveAdvancedRequestInfo":{"properties":{"device":{"description":"device type\noptional field\nonly value: desktop","type":["string","null"]},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name \nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nchoose from the following values: windows, macos\ndefault value: windows","type":["string","null"]},"subtitles_language":{"description":"language code of original text\nyou can get the language code from YouTube Video Info result","type":["string","null"]},"subtitles_translate_language":{"description":"language code of translated text\npossible values:\n\"az\", \"ay\", \"ak\", \"sq\", \"am\", \"en\", \"ar\", \"hy\", \"as\", \"af\", \"eu\", \"be\", \"bn\", \"my\", \"bg\", \"bs\", \"bho\", \"cy\", \"hu\", \"vi\", \"haw\", \"ht\", \"gl\", \"lg\", \"el\", \"ka\", \"gn\", \"gu\", \"gd\", \"da\", \"fy\", \"zu\", \"iw\", \"ig\", \"yi\", \"id\", \"ga\", \"is\", \"es\", \"it\", \"yo\", \"kk\", \"kn\", \"ca\", \"qu\", \"rw\", \"ky\", \"zh-Hant\", \"zh-Hans\", \"ko\", \"co\", \"xh\", \"ku\", \"km\", \"lo\", \"la\", \"lv\", \"ln\", \"lt\", \"lb\", \"mk\", \"mg\", \"ms\", \"ml\", \"dv\", \"mt\", \"mi\", \"mr\", \"mn\", \"und\", \"de\", \"ne\", \"nl\", \"no\", \"ny\", \"or\", \"om\", \"pa\", \"fa\", \"pl\", \"pt\", \"ps\", \"ro\", \"ru\", \"sm\", \"sa\", \"ceb\", \"nso\", \"sr\", \"si\", \"sd\", \"sk\", \"sl\", \"so\", \"sw\", \"su\", \"tg\", \"th\", \"ta\", \"tt\", \"te\", \"ti\", \"ts\", \"tr\", \"tk\", \"uz\", \"ug\", \"uk\", \"ur\", \"fil\", \"fi\", \"fr\", \"ha\", \"hi\", \"hmn\", \"hr\", \"cs\", \"sv\", \"sn\", \"ee\", \"eo\", \"et\", \"st\", \"jv\", \"ja\", \"kri\"","type":["string","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]},"video_id":{"description":"ID of the video\nrequired field\nyou can find video ID in the URL or 'youtube_video' item of YouTube Organic result\nexample:\nY8Wu4rSNJms","type":"string"}},"type":"object"},"Provider0A3E90081762_SerpYoutubeVideoSubtitlesTaskPostRequestInfo":{"properties":{"device":{"description":"device type\noptional field\nonly value: desktop","type":["string","null"]},"language_code":{"description":"search engine language code\nrequired field if you don't specify language_name\nif you use this field, you don't need to specify language_name\nyou can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nen","type":["string","null"]},"language_name":{"description":"full name of search engine language\nrequired field if you don't specify language_code\nif you use this field, you don't need to specify language_code\nyou can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages\nexample:\nEnglish","type":["string","null"]},"location_code":{"description":"search engine location code\nrequired field if you don't specify location_name\nif you use this field, you don't need to specify location_name\nyou can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\n2840","type":["integer","null"]},"location_name":{"description":"full name of search engine location\nrequired field if you don't specify location_code\nif you use this field, you don't need to specify location_code\nyou can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations\nexample:\nUnited States","type":["string","null"]},"os":{"description":"device operating system\noptional field\nchoose from the following values: windows, macos\ndefault value: windows","type":["string","null"]},"pingback_url":{"description":"notification URL of a completed task\noptional field\nwhen a task is completed we will notify you by GET request sent to the URL you have specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/pingscript?id=$id\nhttp://your-server.com/pingscript?id=$id&tag=$tag\nNote: special characters in pingback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"postback_data":{"description":"postback_url datatype\nrequired field if you specify postback_url\ncorresponds to the datatype that will be sent to your server\npossible value:\nadvanced","type":["string","null"]},"postback_url":{"description":"return URL for sending task results\noptional field\nonce the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified\nyou can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.\nexample:\nhttp://your-server.com/postbackscript?id=$id\nhttp://your-server.com/postbackscript?id=$id&tag=$tag\nNote: special characters in postback_url will be urlencoded;\ni.a., the # character will be encoded into %23\nlearn more on our Help Center","type":["string","null"]},"priority":{"description":"task priority\noptional field\ncan take the following values:\n1 – normal execution priority (set by default)\n2 – high execution priority\nYou will be additionally charged for the tasks with high execution priority.\nThe cost can be calculated on the Pricing page.","type":["integer","null"]},"subtitles_language":{"description":"language code of original text\nyou can get the language code from YouTube Video Info result","type":["string","null"]},"subtitles_translate_language":{"description":"language code of translated text\npossible values:\n\"az\", \"ay\", \"ak\", \"sq\", \"am\", \"en\", \"ar\", \"hy\", \"as\", \"af\", \"eu\", \"be\", \"bn\", \"my\", \"bg\", \"bs\", \"bho\", \"cy\", \"hu\", \"vi\", \"haw\", \"ht\", \"gl\", \"lg\", \"el\", \"ka\", \"gn\", \"gu\", \"gd\", \"da\", \"fy\", \"zu\", \"iw\", \"ig\", \"yi\", \"id\", \"ga\", \"is\", \"es\", \"it\", \"yo\", \"kk\", \"kn\", \"ca\", \"qu\", \"rw\", \"ky\", \"zh-Hant\", \"zh-Hans\", \"ko\", \"co\", \"xh\", \"ku\", \"km\", \"lo\", \"la\", \"lv\", \"ln\", \"lt\", \"lb\", \"mk\", \"mg\", \"ms\", \"ml\", \"dv\", \"mt\", \"mi\", \"mr\", \"mn\", \"und\", \"de\", \"ne\", \"nl\", \"no\", \"ny\", \"or\", \"om\", \"pa\", \"fa\", \"pl\", \"pt\", \"ps\", \"ro\", \"ru\", \"sm\", \"sa\", \"ceb\", \"nso\", \"sr\", \"si\", \"sd\", \"sk\", \"sl\", \"so\", \"sw\", \"su\", \"tg\", \"th\", \"ta\", \"tt\", \"te\", \"ti\", \"ts\", \"tr\", \"tk\", \"uz\", \"ug\", \"uk\", \"ur\", \"fil\", \"fi\", \"fr\", \"ha\", \"hi\", \"hmn\", \"hr\", \"cs\", \"sv\", \"sn\", \"ee\", \"eo\", \"et\", \"st\", \"jv\", \"ja\", \"kri\"","type":["string","null"]},"tag":{"description":"user-defined task identifier\noptional field\nthe character limit is 255\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag value in the data object of the response","type":["string","null"]},"video_id":{"description":"ID of the video\nrequired field\nyou can find video ID in the URL or 'youtube_video' item of YouTube Organic result\nexample:\nY8Wu4rSNJms","type":"string"}},"type":"object"},"Provider3F1A62754080_Address":{"description":"Ethereum address (0x-prefixed, 40 hex chars)","example":"0x6e0c80c90ea6c15917308F820Eac91Ce2724B5b5","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"Provider3F1A62754080_SignatureParams":{"properties":{"baseGas":{"description":"Base gas","example":"0","type":"string"},"gasPrice":{"description":"Gas price","example":"0","type":"string"},"gasToken":{"$ref":"#/components/schemas/Provider3F1A62754080_Address"},"operation":{"description":"Operation type","example":"0","type":"string"},"refundReceiver":{"$ref":"#/components/schemas/Provider3F1A62754080_Address"},"safeTxnGas":{"description":"Safe transaction gas","example":"0","type":"string"}},"type":"object"},"Provider3F1A62754080_SubmitRequest":{"properties":{"data":{"description":"Encoded transaction data (0x-prefixed hex string)","example":"0x...","type":"string"},"from":{"$ref":"#/components/schemas/Provider3F1A62754080_Address"},"nonce":{"description":"Transaction nonce","example":"60","type":"string"},"proxyWallet":{"$ref":"#/components/schemas/Provider3F1A62754080_Address"},"signature":{"description":"Transaction signature (0x-prefixed hex string)","example":"0x01a060c734d7bdf4adde50c4a7e574036b1f8b12890911bdd1c1cfdcd77502381b89fa8a47c36f62a0b9f1cdfee7b260fd8108536db9f6b2089c02637e7de9fc20","type":"string"},"signatureParams":{"$ref":"#/components/schemas/Provider3F1A62754080_SignatureParams"},"to":{"$ref":"#/components/schemas/Provider3F1A62754080_Address"},"type":{"description":"Transaction type","enum":["SAFE","PROXY"],"example":"SAFE","type":"string"}},"required":["from","to","proxyWallet","data","nonce","signature","signatureParams","type"],"type":"object"},"Provider65D835437A58_Address":{"description":"User Profile Address (0x-prefixed, 40 hex chars)","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"Provider65D835437A58_Hash64":{"description":"0x-prefixed 64-hex string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"Provider68C5148660B1_BatchPricesHistoryRequest":{"properties":{"end_ts":{"description":"Filter by items before this unix timestamp (seconds).","format":"double","type":"number"},"fidelity":{"description":"Accuracy of the data expressed in minutes. Default is 1 minute.","type":"integer"},"interval":{"description":"Time interval for data aggregation.","enum":["max","all","1m","1w","1d","6h","1h"],"type":"string"},"markets":{"description":"List of market asset ids to query. Maximum 20.","items":{"type":"string"},"maxItems":20,"type":"array"},"start_ts":{"description":"Filter by items after this unix timestamp (seconds).","format":"double","type":"number"}},"required":["markets"],"type":"object"},"Provider68C5148660B1_BookRequest":{"properties":{"side":{"description":"Order side (optional, not used for midpoint calculation)","enum":["BUY","SELL"],"example":"BUY","type":"string"},"token_id":{"description":"Token ID (asset ID)","example":"0xabc123def456...","type":"string"}},"required":["token_id"],"type":"object"},"Provider68C5148660B1_CancelOrderPayload":{"properties":{"orderID":{"description":"Order ID (order hash) to cancel","example":"0xabcdef1234567890abcdef1234567890abcdef12","type":"string"}},"required":["orderID"],"type":"object"},"Provider68C5148660B1_Order":{"description":"Order payload submitted to the CLOB API. In CLOB V2, `expiration` remains in\nthe POST /order wire body for GTD/order-expiry handling, but it is not part\nof the EIP-712 signed order struct.\n","properties":{"builder":{"description":"Builder code (bytes32) for integrator attribution. `0x` + 64 hex chars or empty.","example":"0x0000000000000000000000000000000000000000000000000000000000000000","type":"string"},"expiration":{"description":"Unix timestamp when the order expires. Present in the API wire body; not part of the CLOB V2 EIP-712 signed order struct.","example":"1735689600","type":"string"},"maker":{"description":"Ethereum address of the maker (In the default case, this is your proxy address)","example":"0x1234567890123456789012345678901234567890","type":"string"},"makerAmount":{"description":"Amount the maker is providing in fixed-math with 6 decimals","example":"100000000","type":"string"},"metadata":{"description":"Reserved for future use","example":"","type":"string"},"salt":{"description":"Random salt for order uniqueness","example":1234567890,"type":"integer"},"side":{"description":"Order side","enum":["BUY","SELL"],"example":"BUY","type":"string"},"signature":{"description":"Cryptographic signature of the order","example":"0x1234abcd...","type":"string"},"signatureType":{"description":"Type of signature (0 = EOA, 1 = POLY_PROXY, 2 = POLY_GNOSIS_SAFE)","enum":[0,1,2],"type":"integer"},"signer":{"description":"Ethereum address of the signer","example":"0x1234567890123456789012345678901234567890","type":"string"},"takerAmount":{"description":"Amount the taker is providing in fixed-math with 6 decimals","example":"200000000","type":"string"},"timestamp":{"description":"Unix timestamp in milliseconds when the order was created (used for order uniqueness)","example":"1735689600000","type":"string"},"tokenId":{"description":"Token ID (asset ID) for the order","example":"0xabc123def456...","type":"string"}},"required":["maker","signer","tokenId","makerAmount","takerAmount","side","expiration","timestamp","builder","signature","salt","signatureType"],"type":"object"},"Provider68C5148660B1_OrderMarketCancelParams":{"properties":{"asset_id":{"description":"Asset ID (token ID)","example":"0xabc123def456...","type":"string"},"market":{"description":"Market (condition ID)","example":"0x0000000000000000000000000000000000000000000000000000000000000001","type":"string"}},"required":["market","asset_id"],"type":"object"},"Provider68C5148660B1_SendOrder":{"properties":{"deferExec":{"default":false,"description":"Whether to defer execution","type":"boolean"},"order":{"$ref":"#/components/schemas/Provider68C5148660B1_Order"},"orderType":{"default":"GTC","description":"Time in force","enum":["GTC","FOK","GTD","FAK"],"type":"string"},"owner":{"description":"UUID of the API key owner","example":"f4f247b7-4ac7-ff29-a152-04fda0a8755a","type":"string"},"postOnly":{"default":false,"description":"Whether the order must rest on the book and not match immediately. Only supported for GTC and GTD orders.","type":"boolean"}},"required":["order","owner"],"type":"object"},"Provider73D692Ab31Ca_ListGenerationRequest":{"properties":{"filters":{"additionalProperties":true,"description":"Structured filter conditions. Use the Filter Builder API to generate valid filters. Cannot be used with query. See filter options at /api-reference/listgen-api.","type":"object"},"limit":{"description":"Maximum companies to return. Default: 50, Max: 500","type":"integer"},"offset":{"description":"Number of results to skip for pagination. Default: 0","type":"integer"},"query":{"description":"Natural language search query (e.g. 'SaaS companies in the US with Series A funding'). Cannot be used with filters.","type":"string"},"sections":{"description":"Data enrichment sections to include. Values: firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology, funding_detail (Subscription, Enterprise), mna_and_investment (Subscription, Enterprise)","items":{"type":"string"},"type":"array"},"sort_by":{"description":"Field to sort results by. Default: relevance","enum":["relevance","revenue_estimate","valuation_estimate","employee_range","total_funding","founded_year"],"type":"string"},"sort_order":{"description":"Sort direction. Default: desc","enum":["asc","desc"],"type":"string"}},"type":"object"},"Provider73D692Ab31Ca_TranslateQueryRequest":{"properties":{"query":{"description":"Natural language description of target companies (e.g. 'series a companies in mumbai working in climate tech').","type":"string"}},"required":["query"],"type":"object"},"Provider762Cca4421D2_Accept":{"enum":["application/json","*/*"],"title":"Accept","type":"string"},"Provider762Cca4421D2_ApproximateUserLocation":{"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},"title":"ApproximateUserLocation","type":"object"},"Provider762Cca4421D2_CacheControl":{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},"Provider762Cca4421D2_Country":{"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","YE","YT","ZA","ZM","ZW"],"title":"Country","type":"string"},"Provider762Cca4421D2_LLMContextParameters":{"properties":{"context_threshold_mode":{"anyOf":[{"$ref":"#/components/schemas/Provider762Cca4421D2_SummarizerContextThresholdMode"},{"type":"null"}],"description":"The mode to use to determine the threshold for including content in context."},"count":{"default":20,"description":"The maximum number of search results considered to select the LLM context data. The default is 20 and the maximum is 50.","maximum":50,"minimum":1,"title":"Count","type":"integer"},"country":{"$ref":"#/components/schemas/Provider762Cca4421D2_SearchCountry","default":"US","description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries."},"enable_local":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to enable local recall. Not setting this value means auto-detect: local recall is used if a location is provided (X-Loc-Lat with X-Loc-Long, or X-Loc-City).","title":"Enable Local"},"enable_source_metadata":{"default":false,"description":"Enable source metadata enrichment (site_name, favicon, thumbnail, description, fetched_content_timestamp) in the sources attribute of the response.","title":"Enable Source Metadata","type":"boolean"},"freshness":{"default":"","description":"\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"goggles":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"},"maximum_number_of_snippets":{"default":50,"description":"Maximum number of different snippets (or chunks of text) to include in LLM context. The default is 2022-04-01to2022-07-30.50 and maximum is 256.","maximum":256,"minimum":1,"title":"Maximum Number Of Snippets","type":"integer"},"maximum_number_of_snippets_per_url":{"default":50,"description":"Maximum number of snippets to include per URL. The default is 50 and maximum is 100.","maximum":100,"minimum":1,"title":"Maximum Number Of Snippets Per Url","type":"integer"},"maximum_number_of_tokens":{"default":8192,"description":"Approximate maximum number of tokens to include in context. The default is 8192 and maximum is 32768.","maximum":32768,"minimum":1024,"title":"Maximum Number Of Tokens","type":"integer"},"maximum_number_of_tokens_per_url":{"default":4096,"description":"Maximum number of tokens to include per URL. The default is 4096 and maximum is 8192.","maximum":8192,"minimum":512,"title":"Maximum Number Of Tokens Per Url","type":"integer"},"maximum_number_of_urls":{"default":20,"description":"Maximum number of different URLs to include in LLM context.","maximum":50,"minimum":1,"title":"Maximum Number Of Urls","type":"integer"},"q":{"description":"The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query.","maxLength":600,"minLength":1,"title":"Q","type":"string"},"safesearch":{"anyOf":[{"$ref":"#/components/schemas/Provider762Cca4421D2_app__models__general__SafeSearch"},{"type":"null"}],"description":"\n
\nstrict.ALL for worldwide."},"extra_snippets":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts.","title":"Extra Snippets"},"freshness":{"default":"","description":"\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"goggles":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"},"include_fetch_metadata":{"default":false,"description":"Include fetch metadata.","examples":[true,false],"title":"Include Fetch Metadata","type":"boolean"},"offset":{"default":0,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","maximum":9,"minimum":0,"title":"Offset","type":"integer"},"operators":{"default":true,"description":"Whether to apply search operators.","examples":[true,false],"title":"Operators","type":"boolean"},"q":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"The user's search query term.","type":"string"},"safesearch":{"$ref":"#/components/schemas/Provider762Cca4421D2_app__models__general__SafeSearch","default":"strict","description":"2022-04-01to2022-07-30.\n
","examples":["off","moderate","strict"],"title":"Safe search"},"search_lang":{"$ref":"#/components/schemas/Provider762Cca4421D2_Language-Input","default":"en","description":"The search language preference. The 2 or more character language code for which the search results are provided."},"spellcheck":{"default":true,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"},"ui_lang":{"$ref":"#/components/schemas/Provider762Cca4421D2_MarketCodes","default":"en-US","description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}},"required":["q"],"title":"NewsSearchParameters","type":"object"},"Provider762Cca4421D2_OpenAIChatRequest":{"properties":{"country":{"default":"us","title":"Country","type":"string"},"enable_citations":{"default":false,"description":"Whether to include inline citation tags in the answer. Requires stream=true and is not supported in research mode.","title":"Enable Citations","type":"boolean"},"enable_entities":{"default":false,"description":"Whether to include inline entity tags in the answer. Requires stream=true and is not supported in research mode.","title":"Enable Entities","type":"boolean"},"enable_research":{"default":false,"description":"Whether to answer with iterative deep research instead of a single search. Requires stream=true.","title":"Enable Research","type":"boolean"},"language":{"default":"en","title":"Language","type":"string"},"max_completion_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Completion Tokens"},"messages":{"description":"The conversation so far. Exactly one user message is supported, e.g. [{"role": "user", "content": "Explain quantum computing"}].","items":{"$ref":"#/components/schemas/Provider762Cca4421D2_UserMessage"},"maxItems":1,"minItems":1,"title":"Messages","type":"array"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"description":"Accepted for OpenAI SDK compatibility and currently ignored: the pairs are not stored or returned.","title":"Metadata"},"model":{"default":"brave-pro","description":"Model ID used to generate the response.","enum":["brave-pro","brave"],"title":"Model","type":"string"},"research_allow_thinking":{"default":true,"description":"Accepted for compatibility. Ignored by the mixer engine behind this API, which always runs research with extended thinking off.","title":"Research Allow Thinking","type":"boolean"},"research_maximum_number_of_iterations":{"default":4,"description":"Maximum number of research iterations.","maximum":5,"minimum":1,"title":"Research Maximum Number Of Iterations","type":"integer"},"research_maximum_number_of_queries":{"default":20,"description":"Maximum number of search queries research mode may issue in total.","maximum":50,"minimum":1,"title":"Research Maximum Number Of Queries","type":"integer"},"research_maximum_number_of_results_per_query":{"default":30,"description":"Maximum number of search results to consider per research query.","maximum":60,"minimum":1,"title":"Research Maximum Number Of Results Per Query","type":"integer"},"research_maximum_number_of_seconds":{"default":180,"description":"Time budget for research, in seconds.","maximum":300,"minimum":1,"title":"Research Maximum Number Of Seconds","type":"integer"},"research_maximum_number_of_tokens_per_query":{"default":8192,"description":"Maximum number of tokens to gather per research query.","maximum":16384,"minimum":1024,"title":"Research Maximum Number Of Tokens Per Query","type":"integer"},"safesearch":{"default":"moderate","title":"Safesearch","type":"string"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Accepted for OpenAI SDK compatibility and currently ignored: answers are not reproducible.","title":"Seed"},"stream":{"default":true,"title":"Stream","type":"boolean"},"web_search_options":{"anyOf":[{"$ref":"#/components/schemas/Provider762Cca4421D2_WebSearchOptions"},{"type":"null"}]}},"required":["messages"],"title":"OpenAIChatRequest","type":"object"},"Provider762Cca4421D2_SearchCountry":{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},"Provider762Cca4421D2_SummarizerContextThresholdMode":{"enum":["disabled","strict","lenient","balanced"],"title":"SummarizerContextThresholdMode","type":"string"},"Provider762Cca4421D2_UserLocation":{"properties":{"approximate":{"$ref":"#/components/schemas/Provider762Cca4421D2_ApproximateUserLocation"},"type":{"const":"approximate","default":"approximate","enum":["approximate"],"title":"Type","type":"string"}},"required":["approximate"],"title":"UserLocation","type":"object"},"Provider762Cca4421D2_UserMessage":{"properties":{"content":{"title":"Content","type":"string"},"role":{"const":"user","default":"user","enum":["user"],"title":"Role","type":"string"}},"required":["content"],"title":"UserMessage","type":"object"},"Provider762Cca4421D2_VideoSearchParameters":{"properties":{"count":{"default":20,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","maximum":50,"minimum":1,"title":"Count","type":"integer"},"country":{"$ref":"#/components/schemas/Provider762Cca4421D2_SearchCountry","default":"US","description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide."},"freshness":{"default":"","description":"\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"include_fetch_metadata":{"default":false,"description":"Include fetch metadata.","examples":[true,false],"title":"Include Fetch Metadata","type":"boolean"},"offset":{"default":0,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","maximum":9,"minimum":0,"title":"Offset","type":"integer"},"operators":{"default":true,"description":"Whether to apply search operators.","examples":[true,false],"title":"Operators","type":"boolean"},"q":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"Q","type":"string"},"safesearch":{"$ref":"#/components/schemas/Provider762Cca4421D2_app__models__general__SafeSearch","default":"moderate","description":"2022-04-01to2022-07-30.\n
","examples":["off","moderate","strict"],"title":"Safe search"},"search_lang":{"$ref":"#/components/schemas/Provider762Cca4421D2_Language-Input","default":"en","description":"The search language preference. The 2 or more character language code for which the search results are provided."},"spellcheck":{"default":true,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"},"ui_lang":{"$ref":"#/components/schemas/Provider762Cca4421D2_MarketCodes","default":"en-US","description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}},"required":["q"],"title":"VideoSearchParameters","type":"object"},"Provider762Cca4421D2_WebSearchOptions":{"properties":{"search_context_size":{"anyOf":[{"enum":["low","medium","high"],"type":"string"},{"type":"null"}],"title":"Search Context Size"},"user_location":{"anyOf":[{"$ref":"#/components/schemas/Provider762Cca4421D2_UserLocation"},{"type":"null"}]}},"title":"WebSearchOptions","type":"object"},"Provider762Cca4421D2_WebSearchParameters":{"properties":{"count":{"default":20,"description":"Search plan.\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"goggles":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"},"goggles_id":{"anyOf":[{"type":"string"},{"type":"null"}],"deprecated":true,"description":"Goggles act as a custom re-ranking on top of Brave’s search index. For more details, refer to the Goggles repository. This parameter is deprecated. Please use the goggles parameter.","title":"Goggles id"},"include_fetch_metadata":{"default":false,"description":"Include fetch metadata.","examples":[false,true],"title":"Include Fetch Metadata","type":"boolean"},"offset":{"default":0,"description":"2022-04-01to2022-07-30.discussions, faq, infobox, news, query, summarizer, videos, web, locations.\n
","examples":["off","moderate","strict"],"title":"Safe search"},"search_lang":{"$ref":"#/components/schemas/Provider762Cca4421D2_Language-Input","default":"en","description":"The 2 or more character language code for which the search results are provided.","title":"Search language"},"spellcheck":{"default":true,"description":"Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"},"summary":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.","examples":[true,false],"title":"Summary"},"text_decorations":{"default":true,"description":"Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).","examples":[true,false],"title":"Text decorations","type":"boolean"},"ui_lang":{"$ref":"#/components/schemas/Provider762Cca4421D2_MarketCodes","default":"en-US","description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","title":"User interface language"},"units":{"anyOf":[{"$ref":"#/components/schemas/Provider762Cca4421D2_MeasurementUnit"},{"type":"null"}],"description":"\n
","examples":["metric","imperial"],"title":"Units"}},"required":["q"],"title":"WebSearchParameters","type":"object"},"Provider762Cca4421D2_app__models__general__SafeSearch":{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},"Provider762Cca4421D2_app__models__products__search__v1__images__SafeSearch":{"enum":["off","strict"],"title":"SafeSearch","type":"string"},"Provider7A88Af0Ff8Eb_Address":{"description":"Ethereum address (0x-prefixed, 40 hex chars)","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"Provider7A88Af0Ff8Eb_DepositRequest":{"properties":{"address":{"$ref":"#/components/schemas/Provider7A88Af0Ff8Eb_Address"}},"required":["address"],"type":"object"},"Provider7A88Af0Ff8Eb_QuoteRequest":{"properties":{"fromAmountBaseUnit":{"description":"Amount of tokens to send","example":"10000000","type":"string"},"fromChainId":{"description":"Source Chain ID","example":"137","type":"string"},"fromTokenAddress":{"description":"Source token address","example":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","type":"string"},"recipientAddress":{"description":"Address of the recipient","example":"0x17eC161f126e82A8ba337f4022d574DBEaFef575","type":"string"},"toChainId":{"description":"Destination Chain ID","example":"137","type":"string"},"toTokenAddress":{"description":"Destination token address","example":"0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB","type":"string"}},"required":["fromAmountBaseUnit","fromChainId","fromTokenAddress","recipientAddress","toChainId","toTokenAddress"],"type":"object"},"Provider7A88Af0Ff8Eb_WithdrawalRequest":{"properties":{"address":{"$ref":"#/components/schemas/Provider7A88Af0Ff8Eb_Address"},"recipientAddr":{"description":"Destination wallet address where funds will be sent","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","type":"string"},"toChainId":{"description":"Destination chain ID (e.g., \"1\" for Ethereum, \"8453\" for Base, \"1151111081099710\" for Solana)","example":"1","type":"string"},"toTokenAddress":{"description":"Destination token contract address","example":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","type":"string"}},"required":["address","toChainId","toTokenAddress","recipientAddr"],"type":"object"},"Provider7B6Efb3B471D_SearchFiltersRequest":{"properties":{"filters":{"description":"An array of filter objects to apply to the search.","items":{"properties":{"field":{"description":"The criteria to filter on. For financial metric fields, use 'gt', 'lt', 'gte', 'lte', 'eq' operators. For 'ticker' and 'cik' fields, use the 'in' operator to filter against multiple values.","type":"string"},"operator":{"description":"The comparison operator. The 'in' operator can only be used with a field value of 'ticker' or 'cik' and lets you filter against multiple values.","enum":["gt","lt","gte","lte","eq","in"],"type":"string"},"value":{"oneOf":[{"description":"The value to compare against for single-value operators (gt, lt, gte, lte, eq)","type":"number"},{"description":"Array of ticker or cik values to compare against when using the 'in' operator","items":{"type":"string"},"type":"array"}]}},"required":["field","operator","value"],"type":"object"},"minItems":1,"type":"array"},"limit":{"default":10,"description":"The maximum number of results to return.","minimum":1,"type":"integer"}},"required":["filters"],"type":"object"},"Provider7B6Efb3B471D_SearchLineItemsRequest":{"properties":{"limit":{"default":1,"description":"The maximum number of results to return.","minimum":1,"type":"integer"},"line_items":{"description":"An array of line items to apply to the search.","items":{"description":"The financial metric to search for.","type":"string"},"minItems":1,"type":"array"},"period":{"default":"ttm","description":"The time period for the financial data.","enum":["annual","quarterly","ttm"],"type":"string"},"tickers":{"description":"An array of tickers to apply to the search.","items":{"description":"The tickers to search for.","type":"string"},"minItems":1,"type":"array"}},"required":["line_items","tickers"],"type":"object"},"ProviderD09F9471A0E8_After":{"description":"Timestamp after which to filter by.","format":"date-time","title":"After","type":"string"},"ProviderD09F9471A0E8_Ascending":{"description":"Sort in ascending temporal order.","title":"Ascending","type":"boolean"},"ProviderD09F9471A0E8_Before":{"description":"Timestamp before which to filter by.","format":"date-time","title":"Before","type":"string"},"ProviderD09F9471A0E8_IncludeBlocked":{"description":"Include blocked in results.","title":"IncludeBlocked","type":"boolean"},"ProviderD09F9471A0E8_IncludeSpam":{"description":"Include spam in results.","title":"IncludeSpam","type":"boolean"},"ProviderD09F9471A0E8_IncludeTrash":{"description":"Include trash in results.","title":"IncludeTrash","type":"boolean"},"ProviderD09F9471A0E8_IncludeUnauthenticated":{"description":"Include unauthenticated in results.","title":"IncludeUnauthenticated","type":"boolean"},"ProviderD09F9471A0E8_Labels":{"description":"Labels to filter by.","items":{"type":"string"},"title":"Labels","type":"array"},"ProviderD09F9471A0E8_Limit":{"description":"Limit of number of items returned.","title":"Limit","type":"integer"},"ProviderD09F9471A0E8_PageToken":{"description":"Page token for pagination.","title":"PageToken","type":"string"},"ProviderD09F9471A0E8_apiKeys_ApiKeyId":{"description":"ID of api key.","title":"ApiKeyId","type":"string"},"ProviderD09F9471A0E8_apiKeys_ApiKeyPermissions":{"description":"Granular permissions for the API key. When ommitted all permissions are granted. Otherwise, only permissions set to true are granted.","properties":{"account_update":{"description":"Update accounts: disable or re-enable an inbox's sign-in at an app. Reading accounts\nneeds only `inbox_read`.","type":"boolean"},"api_key_create":{"description":"Create API keys.","type":"boolean"},"api_key_delete":{"description":"Delete API keys.","type":"boolean"},"api_key_read":{"description":"Read API keys.","type":"boolean"},"api_key_update":{"description":"Update API keys.","type":"boolean"},"app_connect":{"description":"Sign in to apps as an inbox: connect an app, authorize an inbox, and mint the\nsign-in keys. Omitted on a new bearer key means false, whatever else the key holds.","type":"boolean"},"app_share_owner":{"description":"Share the organization owner's name and email with apps at sign-in. One permission\nfor both values.","type":"boolean"},"calendar_event_create":{"description":"Create calendar events.","type":"boolean"},"calendar_event_delete":{"description":"Delete calendar events.","type":"boolean"},"calendar_event_read":{"description":"Read calendar events, and receive `calendar.event.*` webhook and WebSocket events.","type":"boolean"},"calendar_event_update":{"description":"Update calendar events and respond to invitations.","type":"boolean"},"calendar_read":{"description":"Read inbox calendar settings.","type":"boolean"},"calendar_update":{"description":"Update inbox calendar settings.","type":"boolean"},"domain_create":{"description":"Create domains.","type":"boolean"},"domain_delete":{"description":"Delete domains.","type":"boolean"},"domain_read":{"description":"Read domain details.","type":"boolean"},"domain_update":{"description":"Update domains.","type":"boolean"},"draft_create":{"description":"Create drafts.","type":"boolean"},"draft_delete":{"description":"Delete drafts.","type":"boolean"},"draft_read":{"description":"Read drafts.","type":"boolean"},"draft_send":{"description":"Send drafts.","type":"boolean"},"draft_update":{"description":"Update drafts.","type":"boolean"},"inbox_create":{"description":"Create new inboxes.","type":"boolean"},"inbox_delete":{"description":"Delete inboxes.","type":"boolean"},"inbox_read":{"description":"Read inbox details.","type":"boolean"},"inbox_update":{"description":"Update inbox settings.","type":"boolean"},"label_blocked_read":{"description":"Access messages labeled blocked.","type":"boolean"},"label_spam_read":{"description":"Access messages labeled spam.","type":"boolean"},"label_trash_read":{"description":"Access messages labeled trash.","type":"boolean"},"label_unauthenticated_read":{"description":"Access messages labeled unauthenticated.","type":"boolean"},"list_entry_create":{"description":"Create list entries.","type":"boolean"},"list_entry_delete":{"description":"Delete list entries.","type":"boolean"},"list_entry_read":{"description":"Read list entries.","type":"boolean"},"message_delete":{"description":"Delete messages. Also required to delete threads.","type":"boolean"},"message_read":{"description":"Read messages. Also required to read threads.","type":"boolean"},"message_reply":{"description":"Reply and reply-all when the request is signed with a registered public key. Bearer keys reply with `message_send`.","type":"boolean"},"message_send":{"description":"Send messages.","type":"boolean"},"message_update":{"description":"Update message labels. Also required to update threads.","type":"boolean"},"metrics_read":{"description":"Read metrics.","type":"boolean"},"pod_create":{"description":"Create pods.","type":"boolean"},"pod_delete":{"description":"Delete pods.","type":"boolean"},"pod_read":{"description":"Read pods.","type":"boolean"},"pod_update":{"description":"Update pods.","type":"boolean"},"webhook_create":{"description":"Create webhooks.","type":"boolean"},"webhook_delete":{"description":"Delete webhooks.","type":"boolean"},"webhook_read":{"description":"Read webhook configurations.","type":"boolean"},"webhook_update":{"description":"Update webhooks.","type":"boolean"}},"title":"ApiKeyPermissions","type":"object"},"ProviderD09F9471A0E8_apiKeys_ApiKeyType":{"enum":["bearer","public_key"],"title":"ApiKeyType","type":"string"},"ProviderD09F9471A0E8_apiKeys_CreateApiKeyRequest":{"description":"A body with `public_key` registers a public-key credential; any other\nbody mints a bearer key.","oneOf":[{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_CreateBearerApiKeyRequest"},{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_CreatePublicKeyRequest"}],"title":"CreateApiKeyRequest"},"ProviderD09F9471A0E8_apiKeys_CreateBearerApiKeyRequest":{"description":"`expires_at` must be in the future and is immutable once the key exists.\nOmitted, the new key inherits the authenticating key's expiry, and never\nexpires only when that key never does. A key cannot create one that\noutlives it: an `expires_at` later than the authenticating key's own\nreturns `403`.","properties":{"expires_at":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_ExpiresAt"},"name":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_Name"},"permissions":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_ApiKeyPermissions"}},"title":"CreateBearerApiKeyRequest","type":"object"},"ProviderD09F9471A0E8_apiKeys_CreatePublicKeyRequest":{"description":"Registers a public P-256 JWK at the route's scope. `type` and\n`api_key_id` are server-owned. `name` defaults to\n`AgentID key {first eight fingerprint characters}`; `permissions`\ndefaults to the registering key's, and only grants it holds may be\ntrue; `expires_at` defaults to the registering key's expiry and is\nindependent of that key afterward.","properties":{"client_id":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_PublicKeyClientId"},"expires_at":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_ExpiresAt"},"name":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_Name"},"permissions":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_ApiKeyPermissions"},"public_key":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_PublicJwk"}},"required":["public_key"],"title":"CreatePublicKeyRequest","type":"object"},"ProviderD09F9471A0E8_apiKeys_ExpiresAt":{"description":"Time at which api key expires. Omitted when it does not expire.","format":"date-time","title":"ExpiresAt","type":"string"},"ProviderD09F9471A0E8_apiKeys_Name":{"description":"Name of api key.","title":"Name","type":"string"},"ProviderD09F9471A0E8_apiKeys_PublicJwk":{"description":"A public P-256 JWK. The object accepts exactly `kty`, `crv`, `x`, and `y`.\nPrivate key material such as `d`, embedded key IDs, and all other members\nare rejected. The server also rejects coordinates that are not a point on\nP-256.","properties":{"crv":{"enum":["P-256"],"type":"string"},"kty":{"enum":["EC"],"type":"string"},"x":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_PublicJwkCoordinate"},"y":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_PublicJwkCoordinate"}},"required":["kty","crv","x","y"],"title":"PublicJwk","type":"object"},"ProviderD09F9471A0E8_apiKeys_PublicJwkCoordinate":{"description":"A 32-byte P-256 coordinate encoded as unpadded base64url.","maxLength":43,"minLength":43,"pattern":"^[A-Za-z0-9_-]{43}$","title":"PublicJwkCoordinate","type":"string"},"ProviderD09F9471A0E8_apiKeys_PublicKeyClientId":{"description":"Caller-chosen alias for a public key, unique within the organization and\nreusable after deletion. Accepted in place of `api_key_id` on get, update,\nand delete. Registration is idempotent on it: the same alias returns the\nexisting key, a conflicting one returns `409`. URL-safe; no slash or `@`.","title":"PublicKeyClientId","type":"string"},"ProviderD09F9471A0E8_apiKeys_UpdateApiKeyRequest":{"description":"Rename a credential or change its permissions. Key material, type,\nscope, and expiry are immutable.","properties":{"name":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_Name"},"permissions":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_apiKeys_ApiKeyPermissions"}},"title":"UpdateApiKeyRequest","type":"object"},"ProviderD09F9471A0E8_attachments_AttachmentContentDisposition":{"description":"Content disposition of attachment.","enum":["inline","attachment"],"title":"AttachmentContentDisposition","type":"string"},"ProviderD09F9471A0E8_attachments_AttachmentContentId":{"description":"Content ID of attachment.","title":"AttachmentContentId","type":"string"},"ProviderD09F9471A0E8_attachments_AttachmentContentType":{"description":"Content type of attachment.","title":"AttachmentContentType","type":"string"},"ProviderD09F9471A0E8_attachments_AttachmentFilename":{"description":"Filename of attachment.","title":"AttachmentFilename","type":"string"},"ProviderD09F9471A0E8_attachments_AttachmentId":{"description":"ID of attachment.","title":"AttachmentId","type":"string"},"ProviderD09F9471A0E8_attachments_SendAttachment":{"description":"Provide either `content` or `url` for each attachment.","properties":{"content":{"description":"Base64 encoded content of the attachment. The entire request, including the message body and all attachments, is limited to 6 MB.","type":"string"},"content_disposition":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_attachments_AttachmentContentDisposition"},"content_id":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_attachments_AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_attachments_AttachmentContentType"},"filename":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_attachments_AttachmentFilename"},"url":{"description":"URL that AgentMail can download without custom authentication headers or cookies.\nRedirects and pre-signed URLs are supported, and the final response must be a\nsuccessful 2xx response. Keep URL-backed attachments around 30 MB total per message.","type":"string"}},"title":"SendAttachment","type":"object"},"ProviderD09F9471A0E8_domains_CreateDomainRequest":{"properties":{"allow_conflicting_provider":{"description":"Allow registration when the domain already has Google Workspace MX records.\nDefaults to false; registration otherwise returns 422 when a conflicting\nprovider is detected.\nThis flag does not configure DNS or inbound routing. For shared Google\nWorkspace domains, follow the [Google Workspace guide](/google-workspace).\nOnly checked when `inbound_enabled` is true; a send-only domain skips the check.","type":"boolean"},"domain":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_domains_DomainName"},"feedback_enabled":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_domains_FeedbackEnabled"},"inbound_enabled":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_domains_InboundEnabled"},"subdomains_enabled":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_domains_SubdomainsEnabled"},"tracking_enabled":{"$ref":"#/components/schemas/ProviderD09F9471A0E8_domains_TrackingEnabled"}},"required":["domain"],"title":"CreateDomainRequest","type":"object"},"ProviderD09F9471A0E8_domains_DomainId":{"description":"The ID of the domain.","title":"DomainId","type":"string"},"ProviderD09F9471A0E8_domains_DomainName":{"description":"The name of the domain (e.g., `example.com`).","title":"DomainName","type":"string"},"ProviderD09F9471A0E8_domains_FeedbackEnabled":{"description":"Bounce and complaint notifications are sent to your inboxes.","title":"FeedbackEnabled","type":"boolean"},"ProviderD09F9471A0E8_domains_InboundEnabled":{"description":"Receive email for this domain. Defaults to `true`. Set `false` for a send-only\ndomain: the apex MX record is not required and is omitted from `records`, so the\ndomain's existing email provider keeps receiving its mail. Inboxes on a send-only\ndomain can still send.","title":"InboundEnabled","type":"boolean"},"ProviderD09F9471A0E8_domains_SubdomainsEnabled":{"description":"Allow inboxes on any subdomain of this domain. Adds a required wildcard MX\nrecord (`*.
you can use this field for matching obtained results with location parameters specified in the request
see the full list of available locations with their geo_id here or by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
example:US-NY","type":["string","null"]},"geo_name":{"description":"location name
you can use this field for matching obtained results with location parameters specified in the request
see the full list of available locations with their geo_name here or by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
example:Andorra","type":["string","null"]},"values":{"description":"contains data on relative keyword popularity by country or region","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AdLinkElement":{"properties":{"ad_aclk":{"description":"the identifier of the ad","type":["string","null"]},"description":{"description":"description of the link","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"title":{"description":"title of the element in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"reference page URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AddressInfo":{"properties":{"address":{"description":"street address of the local establishment","type":["string","null"]},"borough":{"description":"administrative unit or district the local establishment belongs to","type":["string","null"]},"city":{"description":"name of the city where the local establishment is located","type":["string","null"]},"country_code":{"description":"ISO country code of the local establishment","type":["string","null"]},"region":{"description":"DMA region the local establishment belongs to","type":["string","null"]},"zip":{"description":"ZIP code of the local establishment","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AdsSearch":{"properties":{"advertiser_id":{"description":"unique identifier of the advertiser account","type":["string","null"]},"creative_id":{"description":"unique identifier of the advertisement","type":["string","null"]},"first_shown":{"description":"date and time when the ad was shown for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”","type":["string","null"]},"format":{"description":"format of the advertisement
possible values: text, image, video","type":["string","null"]},"last_shown":{"description":"date and time when the ad was shown the last time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”","type":["string","null"]},"preview_image":{"description":"preview image of the advertisement","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PreviewImage"}],"type":["object","null"]},"preview_url":{"description":"url pointing to the ad preview","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]},"verified":{"description":"verified advertiser account
equals true if advertiser account is verified by Google Ads","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_Advertiser":{"properties":{"advertiser_id":{"description":"unique identifier of the advertiser account
can be used to obtain data on advertising campaigns from the Google Ads Search endpoint","type":["string","null"]},"approx_ads_count":{"description":"ads count
the approximate number of ads that are run by the advertiser account across all available Google Ads platforms","format":"int64","type":["integer","null"]},"location":{"description":"location of the advertiser account
country code associated with the advertiser account","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"verified":{"description":"verified advertiser account
equals true if advertiser account is verified by Google Ads","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AggregatedMetricsInfoTotalInfo":{"properties":{"ai_search_volume":{"description":"aggregated AI search volume for mentions within this grouping
learn more about this metric here","format":"int64","type":["integer","null"]},"mentions":{"description":"total LLM mentions count
the number of times the target keyword or domain were mentioned in relation to this specific grouping key","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AggregatedMetricsItemInfo":{"properties":{"ai_search_volume":{"description":"aggregated AI search volume for mentions within this grouping
learn more about this metric here","format":"int64","type":["integer","null"]},"key":{"description":"grouping identifier
the specific identifier for the grouping dimension","type":["string","null"]},"mentions":{"description":"total LLM mentions count
the number of times the target keyword or domain were mentioned in relation to this specific grouping key","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiModeAiOverviewExpandedComponentInfo":{"properties":{"images":{"description":"images of the component
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeLinkElementInfo"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"additional text of the element in SERP","type":["string","null"]},"title":{"description":"reference page title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeAiOverviewInfo":{"properties":{"items":{"description":"items present in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
the text of the ai_overview formatted in the markdown markup language","type":["string","null"]},"page":{"description":"SERP page
SERP page on which the element ranks","type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"references":{"description":"additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeAiOverviewPaidElementInfo":{"properties":{"ad_aclk":{"description":"unique ad click referral parameter
using this parameter you can get a URL of the advertisement in Google Shopping Sellers Ad URL","type":["string","null"]},"breadcrumb":{"description":"breadcrumb path displayed in the ad","type":["string","null"]},"domain":{"description":"domain name of the reference","type":["string","null"]},"images":{"description":"images present in the ad
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"snippet":{"description":"description text of the ad","type":["string","null"]},"title":{"description":"title of the element in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"reference page URL","type":["string","null"]},"website_name":{"description":"displayed name of the advertiser's website","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeAiOverviewReferenceInfo":{"properties":{"domain":{"description":"domain name of the reference","type":["string","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"text":{"description":"text of the component","type":["string","null"]},"title":{"description":"link anchor text","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"link URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeAiOverviewShoppingElementInfo":{"properties":{"data_docid":{"description":"unique identifier of the SERP data element","type":["string","null"]},"domain":{"description":"domain in link","type":["string","null"]},"gid":{"description":"global product identifier on Google Shopping
learn more about the parameter in this help center guide","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"marketplace":{"description":"merchant account provider
e-commerce site that hosts products or websites of individual sellers under the same merchant account
example:by Google","type":["string","null"]},"marketplace_url":{"description":"URL to the merchant account provider
e-commerce site that hosts products or websites of individual sellers under the same merchant account","type":["string","null"]},"price":{"description":"product price
product price details on the seller's website;
if there is none, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"product_id":{"description":"unique product identifier on Google Shopping
learn more about the parameter in this help center guide","type":["string","null"]},"rating":{"description":"product rating
the popularity rate based on reviews
if there is none, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"seller":{"description":"product seller
name of the product's seller as displayed in search results","type":["string","null"]},"snippet":{"description":"additional information about the result","type":["string","null"]},"title":{"description":"reference page title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL in link","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeImagesElementInfo":{"properties":{"alt":{"description":"alt tag of the image","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"relevant URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeLinkElementInfo":{"properties":{"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiModeRectangleInfo":{"properties":{"height":{"description":"height of the element in pixels","format":"double","type":["number","null"]},"width":{"description":"width of the element in pixels","format":"double","type":["number","null"]},"x":{"description":"x-axis coordinate\nx-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin","format":"double","type":["number","null"]},"y":{"description":"y-axis coordinate\ny-axis coordinate of the top-left corner of the result’s snippet, where top-left corner of the screen is the origin","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_AiModeTableInfo":{"properties":{"table_content":{"description":"array of contents of the table present in the element
each array represents the table row","items":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["array","null"]},"table_header":{"description":"content in the header of the table","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AiMonthlySearches":{"properties":{"ai_search_volume":{"description":"current AI search volume rate of a keyword
learn more about this metric here","format":"int64","type":["integer","null"]},"month":{"description":"month","type":["integer","null"]},"year":{"description":"year","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveItem":{"properties":{"ai_monthly_searches":{"description":"monthly AI search volume rates
array of objects with AI search volume rates in a certain month of a year","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiMonthlySearches"}],"type":["object","null"]},"type":["array","null"]},"ai_search_volume":{"description":"current AI search volume rate of a keyword
learn more about this metric here","format":"int64","type":["integer","null"]},"keyword":{"description":"specified keyword","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResultInfo":{"properties":{"items":{"description":"contains specified keywords with their AI search volume rates","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataLocationsAndLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationAiKeywordDataLocationsAndLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataLocationsAndLanguagesResultInfo":{"properties":{"available_languages":{"description":"supported languages
contains the languages which are supported for a specific location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvailableLanguages"}],"type":["object","null"]},"type":["array","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationAiKeywordDataLocationsAndLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationAiKeywordDataLocationsAndLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"description":"number of reasoning tokens
total count of tokens used to generate reasoning content","type":["integer","null"]},"web_search":{"description":"indicates if web search was used","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesModelsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesModelsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesModelsResultInfo":{"properties":{"model_name":{"description":"name of the AI model","type":["string","null"]},"task_post_supported":{"description":"indicates if Standard (POST-GET) data retrieval is supported
if true, you can use the Standard (POST-GET) data retrieval method with the AI model","type":["boolean","null"]},"web_search_supported":{"description":"web search support for the AI model
if true, the web_search parameter can be set with the AI model","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesModelsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesModelsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskGetResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"description":"number of reasoning tokens
total count of tokens used to generate reasoning content","type":["integer","null"]},"web_search":{"description":"indicates if web search was used","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"LLM model specified when setting the task","type":["string","null"]},"se_type":{"type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmResponsesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedResultInfo":{"properties":{"brand_entities":{"description":"array of brand entities
contains information on brands mentioned in the response","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptBrandEntity"}],"type":["object","null"]},"type":["array","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"item_types":{"description":"types of search results
contains types of search results (items) found in SERP.
possible item types:chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of ChatGPT results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"model":{"description":"indicates the model version","type":["string","null"]},"se_results_count":{"description":" total number of results","format":"int64","type":["integer","null"]},"search_results":{"description":"array of search results
all web search outputs the model retrieved when looking up information, including duplicates and unused entries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatgptSearchResult"}],"type":["object","null"]},"type":["array","null"]},"sources":{"description":"array of sources
the sources the model actually cited or relied on in its final answer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetAdvancedResultInfo":{"properties":{"brand_entities":{"description":"array of brand entities
contains information on brands mentioned in the response","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptBrandEntity"}],"type":["object","null"]},"type":["array","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"item_types":{"description":"types of search results
contains types of search results (items) found.
possible item types:chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items present in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"model":{"description":"indicates the model version","type":["string","null"]},"se_results_count":{"description":" total number of results","format":"int64","type":["integer","null"]},"search_results":{"description":"array of search results
all web search outputs the model retrieved when looking up information, including duplicates and unused entries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatgptSearchResult"}],"type":["object","null"]},"type":["array","null"]},"sources":{"description":"array of sources
the sources the model actually cited or relied on in its final answer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"description":"number of reasoning tokens
total count of tokens used to generate reasoning content","type":["integer","null"]},"web_search":{"description":"indicates if web search was used","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesModelsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesModelsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesModelsResultInfo":{"properties":{"model_name":{"description":"name of the AI model","type":["string","null"]},"task_post_supported":{"description":"indicates if Standard (POST-GET) data retrieval is supported
if true, you can use the Standard (POST-GET) data retrieval method with the AI model","type":["boolean","null"]},"web_search_supported":{"description":"web search support for the AI model
if true, the web_search parameter can be set with the AI model","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesModelsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesModelsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskGetResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"description":"number of reasoning tokens
total count of tokens used to generate reasoning content","type":["integer","null"]},"web_search":{"description":"indicates if web search was used","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"LLM model specified when setting the task","type":["string","null"]},"se_type":{"type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationClaudeLlmResponsesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"description":"number of reasoning tokens
total count of tokens used to generate reasoning content","type":["integer","null"]},"web_search":{"description":"indicates if web search was used","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesModelsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesModelsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesModelsResultInfo":{"properties":{"model_name":{"description":"name of the AI model","type":["string","null"]},"task_post_supported":{"description":"indicates if Standard (POST-GET) data retrieval is supported
if true, you can use the Standard (POST-GET) data retrieval method with the AI model","type":["boolean","null"]},"web_search_supported":{"description":"web search support for the AI model
if true, the web_search parameter can be set with the AI model","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesModelsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesModelsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskGetResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","items":{"type":["string","null"]},"type":["array","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"description":"number of reasoning tokens
total count of tokens used to generate reasoning content","type":["integer","null"]},"web_search":{"description":"indicates if web search was used","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"LLM model specified when setting the task","type":["string","null"]},"se_type":{"type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmResponsesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results
contains types of search results (items) found in SERP.
possible item types:gemini_text, gemini_table, gemini_images","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of Gemini results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseGeminiLlmScraperElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"model":{"description":"indicates the model version","type":["string","null"]},"se_results_count":{"description":" total number of results","format":"int64","type":["integer","null"]},"sources":{"description":"array of sources
the sources the model actually cited or relied on in its final answer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:\"location_code\": 9041134,
\"location_name\": \"Vienna International Airport,Lower Austria,Austria\",
\"location_code_parent\": 20044location_code_parent corresponds to:\"location_code\": 20044,","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetAdvancedResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
\"location_name\": \"Lower Austria,Austria\"
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results
contains types of search results (items) found in SERP.
possible item types:gemini_text, gemini_table, gemini_images","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items present in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseGeminiLlmScraperElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"model":{"description":"indicates the model version","type":["string","null"]},"se_results_count":{"description":" total number of results","format":"int64","type":["integer","null"]},"sources":{"description":"array of sources
the sources the model actually cited or relied on in its final answer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the Advanced task
if the Advanced function is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the HTML task
if the HTML function is not supported in the specified endpoint, the value will be null","type":["string","null"]},"function":{"description":"search engine function
example: llm_scraper","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationGeminiLlmScraperTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsAvailableFiltersResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsAvailableFiltersTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsAvailableFiltersResultInfo":{"properties":{"multi_target_metrics":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"search":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"search_mentions":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"target_metrics":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"target_metrics_lite":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_brand_categories":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_brand_categories_lite":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_brands":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_brands_lite":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_domains":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_domains_lite":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_pages":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"top_mentioned_pages_lite":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsAvailableFiltersTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsAvailableFiltersResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveItem":{"properties":{"metrics":{"description":"aggregated mentions metrics for the given month of a year","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]},"month":{"description":"month","type":["integer","null"]},"year":{"description":"year","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveResultInfo":{"properties":{"items":{"description":"array of historical mention metrics
contains objects with historical mention metrics for the specified target
each object contains aggregated mentions metrics for one calendar month","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of resuts returned in the items array
","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsLocationsAndLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsLocationsAndLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsLocationsAndLanguagesResultInfo":{"properties":{"available_languages":{"description":"supported languages
contains the languages which are supported for a specific location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ResultAvailableLanguages"}],"type":["object","null"]},"type":["array","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsLocationsAndLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsLocationsAndLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveItem":{"properties":{"brand_entities_category":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity categories that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"brand_entities_title":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity titles that appear in search results related to LLM queries
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"key":{"description":"grouping key
the specific identifier for the group dimension","type":["string","null"]},"language":{"description":"language-based grouping
array of objects containing mention metrics segmented by content language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"location":{"description":"location-based grouping
array of objects containing mention metrics segmented by geographical location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"platform":{"description":"platform-based grouping
array of group elements containing mention metrics segmented by AI platform","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"search_results_domain":{"description":"found top search results domains relevant to the target
array of objects containing data on top domains that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sources_domain":{"description":"found top source domains relevant to the target
array of objects containing data on top domains that are cited as sources in LLM responses
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"total":{"description":"data on total mentions and search volume for the target","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all LLM mentions that match at least one target specified in the request","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMentionsAggregatedMetricsInfo"}],"type":["object","null"]},"items":{"description":"contains relevant mentions data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"offset in the results array of the returned mentions dataoffset specified in the request","type":["integer","null"]},"total_count":{"description":"total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveItem":{"properties":{"ai_search_volume":{"description":"current AI search volume rate of a keyword
learn more about this metric here","format":"int64","type":["integer","null"]},"answer":{"description":"relevant answer in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"brand_entities":{"description":"array of brand entities
contains information on brands mentioned in the response
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BrandEntities"}],"type":["object","null"]},"type":["array","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response
Note: available only for chat_gpt","items":{"type":["string","null"]},"type":["array","null"]},"first_response_at":{"description":"date and time when the response data was first recorded
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2025-10-21 06:25:30 +00:00","type":["string","null"]},"is_web_search_based":{"description":"indicates whether the response was generated using web search results
if true, the model retrieved live web search results to produce the response
if false, the response was generated from the model's internal knowledge","type":["boolean","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"last_response_at":{"description":"date and time when the response data was last updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2025-10-21 06:25:30 +00:00","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"model_name":{"description":"name of the AI model from which the data was retrieved
Note: for the google platform type, the value is always google_ai_overview","type":["string","null"]},"monthly_searches":{"description":"monthly AI search volume rates
array of objects with AI search volume rates in a certain month of a year","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"platform":{"description":"platform received in a POST array","type":["string","null"]},"question":{"description":"relevant question","type":["string","null"]},"search_results":{"description":"array of search results
all web search outputs the model retrieved when looking up information, including duplicates and unused entries
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchResults"}],"type":["object","null"]},"type":["array","null"]},"sources":{"description":"array of sources
the sources the model cited or relied on in its final answer
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Sources"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveResultInfo":{"properties":{"items":{"description":"contains relevant mentions data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"type":["integer","null"]},"search_after_token":{"description":"token for subsequent requests
by specifying the unique search_after_token when setting a new task, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task","type":["string","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveItem":{"properties":{"language":{"description":"language identifier
language of aggregated metrics","type":["string","null"]},"location":{"description":"location identifier
location of aggregated metrics","type":["integer","null"]},"metrics":{"description":"LLM metrics
metrics aggregated by specific parameters and respective identifiers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]},"platform":{"description":"LLM platform identifiers
LLM platform of aggregated metrics","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics
in this case, always returns null","type":["object","null"]},"items":{"description":"array of aggregated mentions metrics
contains objects with aggregated mention metrics for the specified target","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":"the number of mentions objects that are omitted in the items array","type":["integer","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics
contains aggregated LLM mention metrics across all found domains, grouped by various dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMentionsAggregatedMetricsInfo"}],"type":["object","null"]},"items":{"description":"individual target results
in this case, equals null","items":{"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array
in this case, always equals 0","format":"int64","type":["integer","null"]},"offset":{"description":"the number of mentions objects that are omitted in the items array
in this case, always equals 0","type":["integer","null"]},"total_count":{"description":"total amount of results relevant to the request
in this case, always equals 0","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveItem":{"properties":{"date":{"description":"date timestamp
date format: \"yyyy-mm-dd\"","type":["string","null"]},"delta_ai_search_volume":{"description":"LLM mentions count delta
the difference in ai_search_volume values between the current timestamp and the previous one
learn more about this metric here","format":"int64","type":["integer","null"]},"delta_mentions":{"description":"LLM mentions count delta
the difference in mentions between the current timestamp and the previous one","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveResultInfo":{"properties":{"items":{"description":"contains relevant LLM mentions timeseries data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveItem":{"properties":{"date":{"description":"date timestamp
date format: \"yyyy-mm-dd\"","type":["string","null"]},"lost_ai_search_volume":{"description":"ai_search_volume decrement
indicates the decrease of ai_search_volume values between the current timestamp and the previous one
learn more about this metric here","format":"int64","type":["integer","null"]},"lost_mentions":{"description":"lost LLM mentions
indicates the LLM responses that contained the specified target at the date_from timestamp, do not contain it at the date_to timestamp","type":["integer","null"]},"new_ai_search_volume":{"description":"ai_search_volume increment
indicates the increase of ai_search_volume values between the current timestamp and the previous one
learn more about this metric here","format":"int64","type":["integer","null"]},"new_mentions":{"description":"new LLM mentions
indicates the LLM responses that contain the target at the date_to timestamp, did not contain it at the date_from timestamp","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveResultInfo":{"properties":{"items":{"description":"contains relevant LLM mentions timeseries data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveItem":{"properties":{"brand_category":{"description":"brand category
brand category identifier of aggregated metrics","type":["string","null"]},"language":{"description":"language identifier
language of aggregated metrics","type":["string","null"]},"location":{"description":"location identifier
location of aggregated metrics","type":["integer","null"]},"metrics":{"description":"LLM metrics
metrics aggregated by specific parameters and respective identifiers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]},"platform":{"description":"LLM platform identifiers
LLM platform of aggregated metrics","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all found domains, grouped by various dimensionsin this case, the value will be null","type":["object","null"]},"items":{"description":"contains relevant mentions data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"offset in the results array of the returned mentions dataoffset specified in the request","type":["integer","null"]},"total_count":{"description":"total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveItem":{"properties":{"brand_category":{"description":"brand category
brand category found in LLM mentions for the specified target","type":["string","null"]},"brand_entities_category":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity categories that appear in search results related to LLM queries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"brand_entities_title":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity titles that appear in search results related to LLM queries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"language":{"description":"language-based grouping
array of objects containing mention metrics segmented by content language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"location":{"description":"location-based grouping
array of objects containing mention metrics segmented by geographical location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"platform":{"description":"platform-based grouping
array of group elements containing mention metrics segmented by AI platform","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"search_results_domain":{"description":"found top search results domains relevant to the target
array of objects containing data on top domains that appear in search results related to LLM queries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sources_domain":{"description":"found top source domains relevant to the target
array of objects containing data on top domains that are cited as sources in LLM responses
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"total":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics
contains aggregated LLM mention metrics across all found brand categories, grouped by various dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMentionsAggregatedMetricsInfo"}],"type":["object","null"]},"items":{"description":"individual brand categories results
array containing detailed mention metrics for each of the found brand categories","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":"the number of mentions objects that are omitted in the items array","type":["integer","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveItem":{"properties":{"brand":{"description":"brand name
brand identifier of aggregated metrics","type":["string","null"]},"language":{"description":"language identifier
language of aggregated metrics","type":["string","null"]},"location":{"description":"location identifier
location of aggregated metrics","type":["integer","null"]},"metrics":{"description":"LLM metrics
metrics aggregated by specific parameters and respective identifiers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]},"platform":{"description":"LLM platform identifiers
LLM platform of aggregated metrics","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all found domains, grouped by various dimensionsin this case, the value will be null","type":["object","null"]},"items":{"description":"contains relevant mentions data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"offset in the results array of the returned mentions dataoffset specified in the reqest","type":["integer","null"]},"total_count":{"description":"total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveItem":{"properties":{"brand":{"description":"brand name
name of the brand found in LLM mentions for the specified target","type":["string","null"]},"brand_entities_category":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity categories that appear in search results related to LLM queries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"brand_entities_title":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity titles that appear in search results related to LLM queries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"language":{"description":"language-based grouping
array of objects containing mention metrics segmented by content language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"location":{"description":"location-based grouping
array of objects containing mention metrics segmented by geographical location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"platform":{"description":"platform-based grouping
array of group elements containing mention metrics segmented by AI platform","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"search_results_domain":{"description":"found top search results domains relevant to the target
array of objects containing data on top domains that appear in search results related to LLM queries","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sources_domain":{"description":"found top source domains relevant to the target
array of objects containing data on top domains that are cited as sources in LLM responses
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"total":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics
contains aggregated LLM mention metrics across all found brands, grouped by various dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMentionsAggregatedMetricsInfo"}],"type":["object","null"]},"items":{"description":"individual domain results
array containing detailed mention metrics for each of the found top domains","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":"the number of mentions objects that are omitted in the items array","type":["integer","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveItem":{"properties":{"domain":{"description":"domain name
domain of aggregated metrics","type":["string","null"]},"language":{"description":"language identifier
language of aggregated metrics","type":["string","null"]},"location":{"description":"location identifier
location of aggregated metrics","type":["integer","null"]},"metrics":{"description":"LLM metrics
metrics aggregated by specific parameters and respective identifiers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]},"platform":{"description":"LLM platform identifiers
LLM platform of aggregated metrics","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all found domains, grouped by various dimensionsin this case, the value will be null","type":["object","null"]},"items":{"description":"contains relevant mentions data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"offset in the results array of the returned mentions dataoffset specified in the reqest","type":["integer","null"]},"total_count":{"description":"total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveItem":{"properties":{"brand_entities_category":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity categories that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"brand_entities_title":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity titles that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"domain":{"description":"domain name
the domain name of the website found in LLM mentions for the specified target","type":["string","null"]},"language":{"description":"language-based grouping
array of objects containing mention metrics segmented by content language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"location":{"description":"location-based grouping
array of objects containing mention metrics segmented by geographical location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"platform":{"description":"platform-based grouping
array of group elements containing mention metrics segmented by AI platform","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"search_results_domain":{"description":"found top search results domains relevant to the target
array of objects containing data on top domains that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sources_domain":{"description":"found top source domains relevant to the target
array of objects containing data on top domains that are cited as sources in LLM responses
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"total":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics
contains aggregated LLM mention metrics across all found domains, grouped by various dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMentionsAggregatedMetricsInfo"}],"type":["object","null"]},"items":{"description":"individual domain results
array containing detailed mention metrics for each of the found top domains","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":"the number of mentions objects that are omitted in the items array","type":["integer","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveItem":{"properties":{"language":{"description":"language identifier
language of aggregated metrics","type":["string","null"]},"location":{"description":"location identifier
location of aggregated metrics","type":["integer","null"]},"metrics":{"description":"LLM metrics
metrics aggregated by specific parameters and respective identifiers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]},"page":{"description":"page URL
page identifier of aggregated metrics","type":["string","null"]},"platform":{"description":"LLM platform identifiers
LLM platform of aggregated metrics","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all found domains, grouped by various dimensionsin this case, the value will be null","type":["object","null"]},"items":{"description":"contains relevant mentions data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"offset in the results array of the returned mentions dataoffset specified in the request","type":["integer","null"]},"total_count":{"description":"total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveItem":{"properties":{"brand_entities_category":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity categories that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"brand_entities_title":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity titles that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"language":{"description":"language-based grouping
array of objects containing mention metrics segmented by content language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"location":{"description":"location-based grouping
array of objects containing mention metrics segmented by geographical location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"page":{"description":"URL of a found page
the URL of a page found in LLM mentions for the specified target","type":["string","null"]},"platform":{"description":"platform-based grouping
array of group elements containing mention metrics segmented by AI platform","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"search_results_domain":{"description":"found top search results domains relevant to the target
array of objects containing data on top domains that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sources_domain":{"description":"found top source domains relevant to the target
array of objects containing data on top domains that are cited as sources in LLM responses
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"total":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveResultInfo":{"properties":{"aggregated_metrics":{"description":"aggregated mentions metrics
contains aggregated LLM mention metrics across all found pages, grouped by various dimensions","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMentionsAggregatedMetricsInfo"}],"type":["object","null"]},"items":{"description":"individual page results
array containing detailed mention metrics for each of the found top mentioned pages","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":"the number of mentions objects that are omitted in the items array","type":["integer","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationPerplexityLlmResponsesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationPerplexityLlmResponsesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationPerplexityLlmResponsesLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"fan_out_queries":{"description":"array of fan-out queries
contains related search queries derived from the main query to provide a more comprehensive response","type":["object","null"]},"input_tokens":{"description":"number of tokens in the input
total count of tokens processed","type":["integer","null"]},"items":{"description":"array of response items
contains structured AI response data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MessageAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model used","type":["string","null"]},"money_spent":{"description":"cost of AI tokens, USD
the price charged by the third-party AI model provider for according to its Pricing","type":["number","null"]},"output_tokens":{"description":"number of tokens in the output
total count of tokens generated in the AI response","type":["integer","null"]},"reasoning_tokens":{"type":["integer","null"]},"web_search":{"description":"indicates if web search was used
Note: web search is enabled by default in Perplexity Sonar models","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationPerplexityLlmResponsesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationPerplexityLlmResponsesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationPerplexityLlmResponsesModelsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationPerplexityLlmResponsesModelsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOptimizationPerplexityLlmResponsesModelsResultInfo":{"properties":{"model_name":{"description":"name of the AI model","type":["string","null"]},"task_post_supported":{"description":"indicates if Standard (POST-GET) data retrieval is supported
if true, you can use the Standard (POST-GET) data retrieval method with the AI model","type":["boolean","null"]},"web_search_supported":{"description":"web search support for the AI model
if true, the web_search parameter can be set with the AI model","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_AiOptimizationPerplexityLlmResponsesModelsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationPerplexityLlmResponsesModelsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AiOverviewElement":{"properties":{"images":{"description":"images of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"content within the item","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOverviewExpandedComponent":{"properties":{"images":{"description":"images of the element
if there is none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]},"title":{"description":"reference page title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AiOverviewSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"asynchronous_ai_overview":{"description":"indicates whether the element is loaded asynchronously
if true, the ai_overview element is loaded asynchronously;
if false, the ai_overview element is loaded from cache;
to obtain the content of ai_overview elements, use the load_async_ai_overview parameter in the POST request","type":["boolean","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
the text of the ai_overview formatted in the markdown markup language","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AmazonApplicableVouchersItem":{"properties":{"fixed_discount":{"description":"value of the fixed discount","type":["number","null"]},"fixed_discount_currency":{"description":"currency code of the fixed discount","type":["string","null"]},"important_details":{"description":"important details about the terms of discount vouchers","type":["string","null"]},"percentage_discount":{"description":"value of the percentage discount
if the discount is fixed, the value will be null","type":["number","null"]},"text":{"description":"text of the voucher","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AmazonDeliveryInfo":{"properties":{"delivery_date_from":{"description":"the earliest date when the product can be shipped","type":["string","null"]},"delivery_date_to":{"description":"the latest date when the product can be delivered","type":["string","null"]},"delivery_message":{"description":"message accompanying the delivery information as posted by the seller","type":["string","null"]},"delivery_price":{"description":"price for the delivery\nprice of the delivery based on the location you specified in the POST request;\nif free delivery is available, the value is null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"fastest_delivery_date_from":{"description":"the earliest date when the product can be delivered with a fast delivery option","type":["string","null"]},"fastest_delivery_date_to":{"description":"the latest date when the product can be delivered with a fast delivery option","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AmazonInfo":{"properties":{"asin":{"description":"ASIN in a POST array","type":["string","null"]},"bought_past_month":{"type":["integer","null"]},"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonDeliveryInfo"}],"type":["object","null"]},"domain":{"description":"Amazon domain","type":["string","null"]},"image_url":{"description":"URL of the product image featured in the results","type":["string","null"]},"is_amazon_choice":{"description":"\"Amazon's choice\" label
if the value is true, the product is marked with the \"Amazon's choice\" label","type":["boolean","null"]},"is_best_seller":{"description":"\"Best Seller\" label
if the value is true, the product is marked with the \"Best Seller\" label","type":["boolean","null"]},"position":{"description":"the alignment of the element in Amazon SERP
can take the following values:left, right","type":["string","null"]},"price_from":{"description":"the regular price of a product
example:49.98","type":["number","null"]},"price_to":{"description":"the upper limit of the product price range
example:384.99","type":["number","null"]},"rank_absolute":{"description":"absolute rank in Amazon SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"properties":{"value":{"description":"the value of the rating","format":"float","type":["number","null"]}},"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"special_offers":{"description":"special offer details
contains special offer details, including coupon and Subscribe & Save discounts","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"product title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of the product page","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AmazonKeywordData":{"properties":{"keyword":{"description":"related keyword","type":["string","null"]},"keyword_info":{"description":"keyword info for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonKeywordInfo"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","format":"int64","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]}}},"Response0A3E90081762_AmazonKeywordInfo":{"properties":{"last_updated_time":{"description":"date and time when keyword data was updated\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nexample: '2019-11-15 12:57:46 +00:00'","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"search_volume":{"description":"average monthly search volume rate\nrepresents the (approximate) number of searches for the provided keyword idea on Amazon","format":"int64","type":["integer","null"]}}},"Response0A3E90081762_AmazonLabelElement":{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AmazonMetricsBundleInfo":{"properties":{"amazon_paid":{"description":"ranking data from Amazon paid SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppMetricsInfo"}],"type":["object","null"]},"amazon_serp":{"description":"ranking data from Amazon organic SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppMetricsInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AmazonProductInfo":{"properties":{"applicable_vouchers":{"description":"array of objects containing information about applicable vouchers","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonApplicableVouchersItem"}],"type":["object","null"]},"type":["array","null"]},"author":{"description":"product brand name","type":["string","null"]},"categories":{"description":"contains related product categories","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Categories"}],"type":["object","null"]},"type":["array","null"]},"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"data_asin":{"description":"ASIN of the product received in a POST array","type":["string","null"]},"description":{"description":"contains description of the product","type":["string","null"]},"details":{"description":"product specs and other details","type":["string","null"]},"image_url":{"description":"the URL of the product image","type":["string","null"]},"is_amazon_choice":{"description":"\"Amazon's choice\" label
if the value is true, the product is marked with the \"Amazon's choice\" label","type":["boolean","null"]},"is_available":{"description":"indicates whether the product is available for ordering
if the value is true, the product can be ordered","type":["boolean","null"]},"is_newer_model_available":{"description":"indicates whether the newer model of the product is available","type":["boolean","null"]},"is_prime_video":{"description":"indicates whether a product has an Amazon Prime Video label
if true, specified product is a part of Amazon Prime Video service","type":["boolean","null"]},"newer_model":{"description":"information about the newer model of the product","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_NewerModel"}],"type":["object","null"]},"parent_asin":{"description":"parent ASIN of the product","type":["string","null"]},"percentage_discount":{"description":"value of the percentage discount","type":["string","null"]},"position":{"description":"the alignment of the element in Amazon SERP
possible values:left, right","type":["string","null"]},"price_from":{"description":"the lower limit of the product price range
example:49.98","type":["number","null"]},"price_to":{"description":"the upper limit of the product price range
example:384.99","type":["number","null"]},"product_asins":{"description":"ASINs of all found product modifications","items":{"type":["string","null"]},"type":["array","null"]},"product_images_list":{"description":"contains URLs for all images of the product displayed on the left side of the main image","items":{"type":["string","null"]},"type":["array","null"]},"product_information":{"description":"contains related product information","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationElementItem"}],"type":["object","null"]},"type":["array","null"]},"product_videos_list":{"description":"contains URLs for all videos of the product displayed on the right side of the main video","items":{"type":["string","null"]},"type":["array","null"]},"rank_absolute":{"description":" absolute rank
absolute position among all the elements in the response array","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"product rating info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"title":{"description":"product title","type":["string","null"]},"top_global_reviews":{"description":"array of objects with top reviews from around the world","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonReviewItem"}],"type":["object","null"]},"type":["array","null"]},"top_local_reviews":{"description":"array of objects with top reviews from target location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonReviewItem"}],"type":["object","null"]},"type":["array","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AmazonRankedSerpElement":{"properties":{"check_url":{"description":"direct URL to Amazon results
you can use it to make sure that we provided accurate results","type":["string","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"previous_updated_time":{"description":"previous to the most recent update of SERP data
in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ”
example:2020-09-12T00:07:43.0733218Z","type":["string","null"]},"se_results_count":{"description":"total number of results in Amazon SERP","format":"int64","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"serp_item":{"description":"contains data on the SERP element
the list of supported SERP elements can be found below","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonInfo"}],"type":["object","null"]},"serp_item_types":{"description":"direct URL to Amazon results
contains types of all search results (items) found in the returned SERP;
possible item types:amazon_serp, amazon_paid, editorial_recommendations, top_rated_from_our_brands, related_searches","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AmazonReviewItem":{"properties":{"helpful_votes":{"description":"helpful votes count
number of users who clicked on the 'Helpful\" button under the review text","type":["string","null"]},"images":{"description":"images of the product submitted by the reviewer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: right","type":["string","null"]},"publication_date":{"description":"date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"review_text":{"description":"content of the review","type":["string","null"]},"subtitle":{"description":"subtitle of the review","type":["string","null"]},"title":{"description":"title of the review","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"type":["string","null"]},"user_profile":{"description":"user profile of the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_UserProfileInfo"}],"type":["object","null"]},"verified":{"description":"indicates whether the review has the \"Verified Purchase\" mark","type":["boolean","null"]},"videos":{"description":"videos of the product submitted by the reviewer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_VideoElement"}],"type":["object","null"]},"type":["array","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AmazonSerpElement":{"properties":{"bought_past_month":{"description":"number of product purchases in the past month","type":["integer","null"]},"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"data_asin":{"description":"unique product identifier on Amazon
note that there is no full list of possible values as the data_asin is a dynamic value assigned by Amazon
example:B07G82D89J","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonDeliveryInfo"}],"type":["object","null"]},"domain":{"description":"Amazon domain","type":["string","null"]},"image_url":{"description":"URL of the product image featured in the results","type":["string","null"]},"is_amazon_choice":{"description":"\"Amazon's choice\" label
if the value is true, the product is marked with the \"Amazon's choice\" label","type":["boolean","null"]},"is_best_seller":{"description":"\"Best Seller\" label
if the value is true, the product is marked with the \"Best Seller\" label","type":["boolean","null"]},"labels":{"description":"product labels
array containing an object with main Amazon labels’ information
if the product contains no labels, the value will be null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"price_from":{"description":"the regular price of a product
example:49.98","type":["number","null"]},"price_to":{"description":"the upper limit of the product price range
example:384.99","type":["number","null"]},"rating":{"description":"product rating info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"special_offers":{"description":"special offer details
contains special offer details, including coupon and Subscribe & Save discounts","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"product title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"the URL of the product page","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AnalysisContentInfo":{"properties":{"author":{"description":"author of the content","type":["string","null"]},"connotation_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"connotation types
contains types of sentiments (sentiment polarity) related to the given citation and probability index per each sentiment type
possible sentiment connotation types: positive, negative, neutral","type":["object","null"]},"content_quality_score":{"description":"content quality score
this value is calculated based on the number of words, sentences and characters the content contains","type":["integer","null"]},"content_type":{"description":"type of content
example:page_content, comment","type":["string","null"]},"date_published":{"description":"date and time when the content was published
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"group_date":{"description":"citation group date and time
indicates content publication date or date and time when our crawler visited the page for the first time;
this field can be used to group citations by date and display citation trends;
date and time are provided in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"highlighted_text":{"description":"highlighted text from the snippet","type":["string","null"]},"language":{"description":"main language of the domain
to obtain a full list of available languages, refer to the Languages endpoint","type":["string","null"]},"level":{"description":"title heading level
indicates h-tag level from 1 (top) to 6 (bottom)","type":["integer","null"]},"main_title":{"description":"page title","type":["string","null"]},"previous_title":{"description":"title of the previous content block","type":["string","null"]},"rating":{"description":"content rating
rating related to content_info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContententRatingInfo"}],"type":["object","null"]},"semantic_location":{"description":"semantic location
indicates semantic element in HTML where the target keyword citation is located
example:article, header","type":["string","null"]},"sentiment_connotations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"sentiment connotations
contains sentiments (emotional reactions) related to the given citation and probability index per each sentiment
possible sentiment connotations: anger, happiness, love, sadness, share, fun","type":["object","null"]},"snippet":{"description":"content snippet","type":["string","null"]},"snippet_length":{"description":"character length of the snippet","type":["integer","null"]},"social_metrics":{"description":"social media engagement metrics
data on social media interactions associated with the content based on website embeds developed and supported by social media platforms","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SocialMetricsInfo"}],"type":["object","null"]},"type":["array","null"]},"text_category":{"description":"text category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"type":"integer"},"type":["array","null"]},"title":{"description":"title of the result","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AnnotationInfo":{"properties":{"direct_url":{"description":"direct URL to the quoted source
contains the original source URL that the Vertex AI redirect in the `url` field leads to","type":["string","null"]},"end_index":{"description":"end of the annotation indexing","type":["integer","null"]},"start_index":{"description":"start of the annotation indexing","type":["integer","null"]},"text":{"description":"text of the reasoning chain section
text of the reasoning chain section summarizing the model's thought process","type":["string","null"]},"title":{"description":"the domain name or title of the quoted source","type":["string","null"]},"url":{"description":"redirect URL to the quoted source
contains a Vertex AI redirect that leads to the original source","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AnswerBoxSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"text":{"description":"text
if there is none, equals null","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppInfoTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppInfoTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppInfoTaskGetAdvancedResultInfo":{"properties":{"app_id":{"description":"application id received in a POST request","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found app info","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppStoreInfoOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppInfoTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppInfoTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
in this case, the value will be null","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found apps
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppStoreSearchOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of app items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"keyword":{"description":"app collection received in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppListTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of resultsin this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsCategoriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListingsCategoriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsCategoriesResultInfo":{"properties":{"category":{"description":"name of the supported app category","type":["string","null"]},"count":{"description":"number of app listings that make up the supported app category","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsCategoriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListingsCategoriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsSearchLiveItem":{"properties":{"app_id":{"description":"ID of the returned app","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"item":{"description":"detailed information about the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppStoreInfoOrganic"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"time_update":{"description":"date and time when SERP data was last updated
in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ”
example:2023-05-23 10:16:19 +00:00","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsSearchLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListingsSearchLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsSearchLiveResultInfo":{"properties":{"count":{"description":"the number of items in the results array","format":"int64","type":["integer","null"]},"items":{"description":"array of apps and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListingsSearchLiveItem"}],"type":["object","null"]},"type":["array","null"]},"offset":{"description":"offset in the results array of returned apps","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
you can use this parameter in the POST request to avoid timeouts while trying to obtain over 100,000 results in a single request","type":["string","null"]},"total_count":{"description":"the total number of relevant results in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppListingsSearchLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppListingsSearchLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppReviewsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppReviewsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppReviewsTaskGetAdvancedResultInfo":{"properties":{"app_id":{"description":"application id received in a POST array","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found reviews","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppStoreReviewsSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"rating":{"description":"rating of the app
rating of the application for which the reviews are collected","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews
in this case, the value will be null as App Store does not indicate the total number of app reviews","format":"int64","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"title":{"description":"title of the app
title of the application for which the reviews are collected","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppReviewsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppReviewsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppReviewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppReviewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppReviewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppSearchesTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppSearchesTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppSearchesTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
in this case, the value will be null","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found apps","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppStoreSearchOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST request","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleAppSearchesTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppSearchesTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppSearchesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleAppSearchesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleAppSearchesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleCategoriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleCategoriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleCategoriesResultInfo":{"properties":{"categories":{"description":"contains full list of supported app categories","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleCategoriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleCategoriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataAppleLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_name_parent":{"description":"the name of the superordinate location\nexample:\n\"location_code\": 1006473,\n\"location_name\": \"Altrincham,England,United Kingdom\",\n\"location_name_parent\": \"England,United Kingdom\", where location_name_parent corresponds to:\n\"location_code\": 20339,\n\"location_name\": \"England,United Kingdom\"\nnote: Apple App Data API currently supports countries only, that is why this value will always be null","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataAppleLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataAppleLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppInfoTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskGetAdvancedResultInfo":{"properties":{"app_id":{"description":"application id received in a POST request","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found app info","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlayInfoOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppInfoTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppInfoTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskGetHtmlResultInfo":{"properties":{"app_id":{"description":"application ID received in a POST request","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppInfoTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found apps","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlaySearchOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of app items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"keyword":{"description":"app collection received in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"app collection received in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsCategoriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListingsCategoriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsCategoriesResultInfo":{"properties":{"category":{"description":"name of the supported app category","type":["string","null"]},"count":{"description":"number of app listings that make up the supported app category","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsCategoriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListingsCategoriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsSearchLiveItem":{"properties":{"app_id":{"description":"ID of the returned app","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"item":{"description":"detailed information about the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlayInfoOrganic"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"time_update":{"description":"date and time when SERP data was last updated
in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ”
example:2023-05-23 10:16:19 +00:00","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsSearchLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListingsSearchLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsSearchLiveResultInfo":{"properties":{"count":{"description":"the number of items in the results array","format":"int64","type":["integer","null"]},"items":{"description":"array of apps and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListingsSearchLiveItem"}],"type":["object","null"]},"type":["array","null"]},"offset":{"description":"offset in the results array of returned apps","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
you can use this parameter in the POST request to avoid timeouts while trying to obtain over 100,000 results in a single request","type":["string","null"]},"total_count":{"description":"the total number of relevant results in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppListingsSearchLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppListingsSearchLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppReviewsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskGetAdvancedResultInfo":{"properties":{"app_id":{"description":"application id received in a POST array","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found reviews
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlayReviewsSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"rating":{"description":"rating of the app
rating of the application for which the reviews are collected","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"title":{"description":"title of the app
title of the application for which the reviews are collected","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppReviewsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppReviewsTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskGetHtmlResultInfo":{"properties":{"app_id":{"description":"app id received in a POST array","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppReviewsTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppReviewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppReviewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppSearchesTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found apps","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlaySearchOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST request","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppSearchesTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppSearchesTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST request","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppSearchesTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleAppSearchesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleAppSearchesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleCategoriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleCategoriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleCategoriesResultInfo":{"properties":{"categories":{"description":"contains full list of supported app categories","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleCategoriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleCategoriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppDataGoogleLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_name_parent":{"description":"the name of the superordinate location
example:\"location_code\": 1006473, where
\"location_name\": \"Altrincham,England,United Kingdom\",
\"location_name_parent\": \"England,United Kingdom\",location_name_parent corresponds to:\"location_code\": 20339,","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppDataGoogleLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppDataGoogleLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"price":{"description":"price indicated in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppMetricsInfo":{"properties":{"count":{"description":"total count of Amazon organic SERPs that contain the product","format":"int64","type":["integer","null"]},"pos_1":{"description":"number of organic SERPs where the product ranks #1","type":["integer","null"]},"pos_11_100":{"description":"number of organic SERPs where the product ranks #11-100","type":["integer","null"]},"pos_2_3":{"description":"number of organic SERPs where the product ranks #2-3","type":["integer","null"]},"pos_4_10":{"description":"number of organic SERPs where the product ranks #4-10","type":["integer","null"]},"search_volume":{"description":"total search volume of the product's ranking keywords in organic SERP","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AppSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
\"location_name\": \"England,United Kingdom\"
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_AppStoreInfoOrganic":{"properties":{"advisories":{"description":"age rating and age-based content advisories","items":{"type":["string","null"]},"type":["array","null"]},"app_id":{"description":"ID of the app","type":["string","null"]},"categories":{"description":"all relevant categories/genres of the app
Note: this field returns only one relevant category in the array","items":{"type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the app","type":["string","null"]},"developer":{"description":"name of the app developer","type":["string","null"]},"developer_id":{"description":"ID of the app developer","type":["string","null"]},"developer_url":{"description":"URL to the developer page on App Store","type":["string","null"]},"icon":{"description":"URL to the app icon","type":["string","null"]},"images":{"description":"app images
contains URLs to the images used on the app page on App Store","items":{"type":["string","null"]},"type":["array","null"]},"is_free":{"description":"indicates whether the app is free","type":["boolean","null"]},"languages":{"description":"languages supported in the app
Note: this field returns only one supported language in the array","items":{"type":["string","null"]},"type":["array","null"]},"last_update_date":{"description":"date and time when the app was last updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"main_category":{"description":"main category/genre of the app","type":["string","null"]},"minimum_os_version":{"description":"minimum OS version required to install the app","type":["string","null"]},"more_apps_by_developer":{"description":"similar apps
information about apps built by the same developer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppsInfo"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values: left","type":["string","null"]},"price":{"description":"price of the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank among all the listed apps
absolute position among all apps on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"average rating of the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"released_date":{"description":"date and time when the app was released
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00
Note: this field is deprecated and always returns null","type":["string","null"]},"reviews_count":{"description":"the total number of reviews of the app","format":"int64","type":["integer","null"]},"similar_apps":{"description":"similar apps
displays apps similar to the app in a POST request","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppsInfo"}],"type":["object","null"]},"type":["array","null"]},"size":{"description":"size of the app","type":["string","null"]},"subtitle":{"description":"subtitle of the app","type":["string","null"]},"title":{"description":"title of the app","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"update_notes":{"description":"update notes
contains the latest update notes from the developer","type":["string","null"]},"url":{"description":"URL to the app page on App Store","type":["string","null"]},"version":{"description":"current version of the app","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppStoreReviewsSearch":{"properties":{"id":{"description":"id of the review","type":["string","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: left","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"review_text":{"description":"content of the review","type":["string","null"]},"timestamp":{"description":"date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the review","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"user_profile":{"description":"user profile of the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppUserProfileInfo"}],"type":["object","null"]},"version":{"description":"version of the app
version of the app for which the review is submitted","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppStoreSearchOrganic":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"icon":{"description":"URL to the app icon","type":["string","null"]},"is_free":{"description":"indicates whether the app is free","type":["boolean","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"price":{"description":"pricing information for the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"average rating of the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews of the app","format":"int64","type":["integer","null"]},"title":{"description":"title of the app","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the app page on App Store","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppUserProfileInfo":{"properties":{"profile_image_url":{"description":"URL to the reviewer's profile image","type":["string","null"]},"profile_name":{"description":"profile name of the reviewer","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AppleRankedSerpElementInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"previous_updated_time":{"description":"previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-10-15 12:57:46 +00:00;
in this case, will equal null","type":["string","null"]},"se_results_count":{"description":"number of search results for the returned keyword","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"serp_item":{"description":"contains data on the SERP element
the list of supported SERP elements can be found below","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppStoreSearchOrganic"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_AppsInfo":{"properties":{"app_id":{"description":"ID of the app","type":["string","null"]},"title":{"description":"title of the app","type":["string","null"]},"url":{"description":"URL to the app page on Google Play","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AudienceEstimationInfo":{"properties":{"high":{"description":"indicates the upper bound of the range result","format":"double","type":["number","null"]},"low":{"description":"indicates the lower bound of the range result","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_AuthorsElement":{"properties":{"domain":{"description":"author’s link domain","type":["string","null"]},"name":{"description":"name of the dataset author","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"author’s link URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_Autocomplete":{"properties":{"highlighted":{"description":"keywords highlighted in autocomplete
contains a list of google autocomplete suggestions that are highlighted in the search bar;
Note: array is only available for the following client:gws-wizpsy-abgws-wiz-local","items":{"type":["string","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"relevance":{"description":"relevance of suggested keyword
represents the relevant of the autocomplete suggestion to the target keyword
can take values from 500 to 2000
the higher the value, the more relevant is the suggestion
Note: only available for the following client:chrome/chrome-omni","type":["integer","null"]},"search_query_url":{"description":"url to search results
url to search results relevant to the google autocomplete suggestion","type":["string","null"]},"suggestion":{"description":"google autocomplete keyword suggestion","type":["string","null"]},"suggestion_type":{"description":"google autocomplete suggestion type
Note: only available for the following client:chrome/chrome-omni","type":["string","null"]},"thumbnail_url":{"description":"url of the thumbnail image
url of the thumbnail image of the google autocomplete suggestion
Note: only available for the following client:gws-wizgws-wiz-serp","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AvailableLanguages":{"properties":{"available_sources":{"description":"supported sources
contains the sources of data supported for a specific location and language combination
only google and bing are currently available","items":{"type":["string","null"]},"type":["array","null"]},"keywords":{"description":"the number of keywords available for the given location and language","type":["integer","null"]},"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]},"serps":{"description":"the number of SERP pages available for the given location and language","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_AvailableLocations":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"location name","type":["string","null"]},"location_type":{"description":"location type
possible values:Country, Region","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AvailibleVersions":{"properties":{"default":{"description":"the version is used by default
if false, the version is not used by default and should be specified in the corresponding field of the POST request if necessary","type":["boolean","null"]},"version":{"description":"lighthouse version","type":["string","null"]}},"type":"object"},"Response0A3E90081762_AvgBacklinksInfo":{"properties":{"backlinks":{"description":"average number of backlinks","type":["number","null"]},"dofollow":{"description":"average number of dofollow links","type":["number","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"main_domain_rank":{"description":"average main domain rank
learn more about the metric and its calculation formula in this help center article","type":["number","null"]},"rank":{"description":"average rank
learn more about the metric and its calculation formula in this help center article","type":["number","null"]},"referring_domains":{"description":"average number of referring domains","type":["number","null"]},"referring_main_domains":{"description":"average number of referring main domains","type":["number","null"]},"referring_pages":{"description":"average number of referring pages","type":["number","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksAnchorsLiveItem":{"properties":{"anchor":{"description":"anchor of the backlink","type":["string","null"]},"backlinks":{"description":"indicates the number of backlinks","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"average spam score of all backlinks with this anchor
learn more about how the metric is calculated on this help center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the target","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that respond with 4xx or 5xx status codes where backlinks are pointing to","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found the backlink with this anchor for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink with this anchor was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"rank":{"description":"rank of the anchor links
rank volume that referring websites pass to the target through links with a particular anchorrank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number of referring domains","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and link count per each semantic location
examples:article, section, summary","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to target with this anchor","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target with this anchor","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksAnchorsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksAnchorsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksAnchorsLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksAnchorsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"target":{"description":"target in the post array","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksAnchorsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksAnchorsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBacklinksLiveItem":{"properties":{"alt":{"description":"alternative text of the image
this field will be null if backlink type is not image","type":["string","null"]},"anchor":{"description":"anchor text of the backlink","type":["string","null"]},"attributes":{"description":"link attributes of the referring links
example:nofollow","items":{"type":["string","null"]},"type":["array","null"]},"backlink_spam_score":{"description":"spam score of the backlink
learn more about how the metric is calculated on this help center page","type":["integer","null"]},"dofollow":{"description":"indicates whether the backlink is dofollow
if false, the backlink is nofollow","type":["boolean","null"]},"domain_from":{"description":"domain referring to the target domain or webpage","type":["string","null"]},"domain_from_country":{"description":"ISO country code of the referring domain","type":["string","null"]},"domain_from_ip":{"description":"IP address of the referring domain","type":["string","null"]},"domain_from_is_ip":{"description":"indicates if the domain is IP
if true, the domain functions as an IP address and does not have a domain name","type":["boolean","null"]},"domain_from_platform_type":{"description":"platform types of the referring domaincms, blogs, ecommerce, message-boards, wikis, news, organization","items":{"type":["string","null"]},"type":["array","null"]},"domain_from_rank":{"description":"domain rank of the referring domaindomain_from_rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"domain_to":{"description":"domain the backlink is pointing to","type":["string","null"]},"first_seen":{"description":"date and time when our crawler found the backlink for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"group_count":{"description":"indicates total number of backlinks from this domain
for example, if mode is set to one_per_domain, this field will indicate the total number of backlinks coming from this domain","format":"int64","type":["integer","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"indirect_link_path":{"description":"indirect link path
indicates a URL or a sequence of URLs that lead to url_to","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksRedirectInfo"}],"type":["object","null"]},"type":["array","null"]},"is_broken":{"description":"indicates whether the backlink is broken
if true, the backlink is pointing to a page responding with a 4xx or 5xx status code","type":["boolean","null"]},"is_indirect_link":{"description":"indicates whether the backlink is an indirect link
if true, the backlink is an indirect link pointing to a page that either redirects to url_to, or points to a canonical page","type":["boolean","null"]},"is_lost":{"description":"indicates whether the backlink was removed
if true, the backlink or the entire page was removed","type":["boolean","null"]},"is_new":{"description":"indicates whether the backlink is new
if true, the backlink was found on the page last time our crawler visited it","type":["boolean","null"]},"item_type":{"description":"link type
possible values:anchor, image, meta, canonical, alternate, redirect","type":["string","null"]},"last_seen":{"description":"most recent date when our crawler visited the backlink
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"links_count":{"description":"number of identical backlinks found on the referring page","format":"int64","type":["integer","null"]},"original":{"description":"indicates whether the backlink was present on the referring page when our crawler first visited it","type":["boolean","null"]},"page_from_encoding":{"description":"character encoding of the referring page
example:utf-8","type":["string","null"]},"page_from_external_links":{"description":"number of external links found on the referring page","type":["integer","null"]},"page_from_internal_links":{"description":"number of internal links found on the referring page","type":["integer","null"]},"page_from_language":{"description":"language of the referring page
in ISO 639-1 format
example:en","type":["string","null"]},"page_from_rank":{"description":"page rank of the referring pagepage_from_rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"page_from_size":{"description":"size of the referring page, in bytes
example:63357","type":["integer","null"]},"page_from_status_code":{"description":"HTTP status code returned by the referring page
example:200","type":["integer","null"]},"page_from_title":{"description":"title of the referring page","type":["string","null"]},"prev_seen":{"description":"previous to the most recent date when our crawler visited the backlink
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"backlink rank
rank that the given backlink passes to the targetrank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"ranked_keywords_info":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankedKeywordsInfo"}],"type":["object","null"]},"semantic_location":{"description":"indicates semantic element in HTML where the backlink is found
you can get the full list of semantic elements here
examples:article, section, summary","type":["string","null"]},"text_post":{"description":"snippet after the anchor text","type":["string","null"]},"text_pre":{"description":"snippet before the anchor text","type":["string","null"]},"tld_from":{"description":"top-level domain of the referring URL","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url_from":{"description":"URL of the page where the backlink is found","type":["string","null"]},"url_from_https":{"description":"indicates whether the referring URL is secured with HTTPS
if true, the referring URL is secured with HTTPS","type":["boolean","null"]},"url_to":{"description":"URL the backlink is pointing to","type":["string","null"]},"url_to_https":{"description":"indicates if the URL the backlink is pointing to is secured with HTTPS
if true, the URL is secured with HTTPS","type":["boolean","null"]},"url_to_redirect_target":{"description":"target url of the redirect
target page the redirect is pointing to","type":["string","null"]},"url_to_spam_score":{"description":"spam score of the referenced page
if the value is null, our crawler hasn't yet visited the webpage the link is pointing to;
learn more about how the metric is calculated on this help center page","type":["integer","null"]},"url_to_status_code":{"description":"status code of the referenced page
if the value is null, our crawler hasn't yet visited the webpage the link is pointing to
example:200","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBacklinksLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBacklinksLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBacklinksLiveResultInfo":{"properties":{"custom_mode":{"additionalProperties":{"type":["object","null"]},"description":"custom mode specified in a POST array","type":["object","null"]},"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBacklinksLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"mode":{"description":"mode specified in a POST array","type":["string","null"]},"search_after_token":{"description":"token for subsequent requests
by specifying the unique search_after_token when setting a new task, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBacklinksLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBacklinksLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkBacklinksLiveItem":{"properties":{"backlinks":{"description":"number of backlinks pointing to the target","format":"int64","type":["integer","null"]},"target":{"description":"domain, subdomain or webpage from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkBacklinksLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkBacklinksLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkBacklinksLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlink data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkBacklinksLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkBacklinksLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkBacklinksLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveItem":{"properties":{"lost_backlinks":{"description":"number of lost backlinks
number of lost backlinks of the target","format":"int64","type":["integer","null"]},"new_backlinks":{"description":"number of new backlinks
number of new backlinks pointing to the target","format":"int64","type":["integer","null"]},"target":{"description":"domain, subdomain or webpage from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkNewLostBacklinksLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveItem":{"properties":{"lost_referring_domains":{"description":"number of lost referring domains
number of lost referring domains of the target","format":"int64","type":["integer","null"]},"lost_referring_main_domains":{"description":"number of lost referring main domains pointing to the target","format":"int64","type":["integer","null"]},"new_referring_domains":{"description":"number of new referring domains
number of new referring domains pointing to the target","format":"int64","type":["integer","null"]},"new_referring_main_domains":{"description":"number of new referring main domains pointing to the target","format":"int64","type":["integer","null"]},"target":{"description":"domain, subdomain or webpage from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkNewLostReferringDomainsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkPagesSummaryLiveItem":{"properties":{"backlinks":{"description":"number of backlinks","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"average spam score of the backlinks pointing to the page
learn more about how the metric is calculated on this help center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the page","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that respond with 4xx or 5xx status codes where backlinks are pointing to","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found a backlink to this page for the first time
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink to this page was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"main_domain_rank":{"description":"rank of the main domain
rank of the main domain is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"rank":{"description":"page rank
rank of the page on the target websiterank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number domains referring to the page","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and link count per each semantic location
examples:article, section, footer","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the relevant url","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"page URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkPagesSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkPagesSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkPagesSummaryLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkPagesSummaryLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkPagesSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkPagesSummaryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkRanksLiveItem":{"properties":{"rank":{"description":"rank of the target
values represent real-time data for the date of the requestrank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"target":{"description":"domain, subdomain or webpage from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkRanksLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkRanksLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkRanksLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkRanksLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkRanksLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkRanksLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkReferringDomainsLiveItem":{"properties":{"referring_domains":{"description":"number of referring domains pointing to the target
note that we calculate main domains (root domains, like example.com) and their subdomains (e.g. blog.example.com) separately for this metric","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_main_domains":{"description":"number of referring main domains pointing to the target
the number of primary (root) domains referring to your target","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"target":{"description":"domain, subdomain or webpage from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkReferringDomainsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkReferringDomainsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkReferringDomainsLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkReferringDomainsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkReferringDomainsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkReferringDomainsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkSpamScoreLiveItem":{"properties":{"spam_score":{"description":"average spam score the target
learn more about how the metric is calculated","type":["integer","null"]},"target":{"description":"domain, subdomain or webpage from a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkSpamScoreLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkSpamScoreLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksBulkSpamScoreLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkSpamScoreLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksBulkSpamScoreLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksBulkSpamScoreLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksCompetitorsLiveItem":{"properties":{"intersections":{"description":"indicates the number of backlink intersections with the target specified in the POST array","type":["integer","null"]},"rank":{"description":"domain rank
domain rank across all domains in the databaserank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"target":{"description":"competitor domain","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksCompetitorsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksCompetitorsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksCompetitorsLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksCompetitorsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the items array","format":"int64","type":["integer","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksCompetitorsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksCompetitorsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksDomainIntersection":{"properties":{"backlinks":{"description":"indicates the number of backlinks","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"average spam score of the backlinks pointing to the target
learn more about how the metric is calculated on this help center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found the backlink from this target for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink from this target was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"rank referred to the target from the POST array
indicates the rank that the referring domain (target above) refers to your target from the POST array;rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"number of referring domains","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the corresponding target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and the link count per each attribute","type":["object","null"]},"referring_links_countries":{"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and the link count per each semantic location
you can get the full list of semantic elements here","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"type":["integer","null"]},"description":"top level domains of the referring links
contains top-level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"type":["integer","null"]},"description":"types of the referring links
indicates the types of referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the target","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"target":{"description":"domain that links to the corresponding target from the POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainIntersectionLiveItem":{"properties":{"domain_intersection":{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainIntersection"}],"type":["object","null"]},"description":"contains data on domains that link to the corresponding targets specified in the POST array
data is provided in separate objects corresponding to domains, subdomains or pages specified in the targets object","type":["object","null"]},"summary":{"description":"contains the domain intersections summary","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_IntersectionSummaryInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainIntersectionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainIntersectionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksDomainIntersectionLiveResultInfo":{"properties":{"items":{"description":"contains domain that link to all targets from the POST array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainIntersectionLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"targets":{"additionalProperties":{"type":["string","null"]},"description":"target domains, subdomains or webpages in a POST array","type":["object","null"]},"total_count":{"description":"total amount of results relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainIntersectionLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainIntersectionLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksDomainPagesLiveItem":{"properties":{"content_encoding":{"description":"type of encoding","type":["string","null"]},"domain":{"description":"domain
domain where the page was found","type":["string","null"]},"encoded_size":{"description":"page size after encoding
indicates the size of the encoded page, in bytes","type":["integer","null"]},"fetch_time":{"description":"most recent date and time when our crawler visited the page
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"first_visited":{"description":"date and time of the first page visit
date and time when our crawler visited this page for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"ip":{"description":"Internet Protocol address","type":["string","null"]},"location":{"description":"location header
indicates the URL to redirect a page to if exists","type":["string","null"]},"main_domain":{"description":"main website domain
main website domain does not include subdomains","type":["string","null"]},"media_type":{"description":"types of media used to display a page","type":["string","null"]},"meta":{"description":"page meta data","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksPageMeta"}],"properties":{"social_media_tags":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":["object","null"]},"page":{"description":"page URL
relevant page URL","type":["string","null"]},"page_summary":{"description":"contains backlink data for this page","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageSummary"}],"properties":{"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"type":["object","null"]},"referring_main_domains_nofollow":{"format":"int64","type":["integer","null"]}},"type":["object","null"]},"prev_visited":{"description":"previous to the most recent date when our crawler visited the page
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"server":{"description":"server version","type":["string","null"]},"size":{"description":"indicates the page size, in bytes","type":["integer","null"]},"status_code":{"description":"general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions","type":["integer","null"]},"tld":{"description":"top-level domain
top-level domain in the DNS root zone","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainPagesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainPagesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksDomainPagesLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainPagesLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the items array","format":"int64","type":["integer","null"]},"target":{"description":"target in a POST array","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainPagesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainPagesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksDomainPagesSummaryLiveItem":{"properties":{"backlinks":{"description":"number of backlinks","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"average spam score of the backlinks pointing to the page
learn more about how the metric is calculated on this help center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the page","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that respond with 4xx or 5xx status codes where backlinks are pointing to","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found a backlink to this page for the first time
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink to this page was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"rank":{"description":"page rank
rank of the pagerank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number domains referring to the page","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the page","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and link count per each semantic location
examples:article, section, footer","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the page","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the relevant url","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the page","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"page URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainPagesSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainPagesSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksDomainPagesSummaryLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainPagesSummaryLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"target":{"description":"target in the post array","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksDomainPagesSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksDomainPagesSummaryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksHistoryLiveItem":{"properties":{"backlinks":{"description":"number of backlinks","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the target","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that receive backlinks but respond with 4xx or 5xx status codes","type":["integer","null"]},"crawled_pages":{"description":"number of crawled pages for the target","type":["integer","null"]},"date":{"description":"date and time when the data for the target was stored
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"external_links_count":{"description":"number of external links on the page
calculated as the sum of external links on the pages of the specified target","format":"int64","type":["integer","null"]},"info":{"description":"information about the target","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TargetInfo"}],"type":["object","null"]},"internal_links_count":{"description":"number of internal links
calculated as the sum of internal links on the pages of the specified target","format":"int64","type":["integer","null"]},"lost_backlinks":{"description":"number of lost backlinks for the target
data is provided based in a comparison with the previous period
Note: this data is available from May 2021;
if the date range specified in the POST request precedes May 2021, the field will equal 0","format":"int64","type":["integer","null"]},"lost_referring_domains":{"description":"number of lost referring domains for the target
data is provided based in a comparison with the previous period
Note: this data is available from May 2021;
if the date range specified in the POST request precedes May 2021, the field will equal 0","format":"int64","type":["integer","null"]},"new_backlinks":{"description":"number of new backlinks for the target
data is provided based in a comparison with the previous period
Note: this data is available from May 2021;
if the date range specified in the POST request precedes May 2021, the field will equal 0","format":"int64","type":["integer","null"]},"new_referring_domains":{"description":"number of new referring domains for the target
data is provided based in a comparison with the previous period
Note: this data is available from May 2021;
if the date range specified in the POST request precedes May 2021, the field will equal 0","format":"int64","type":["integer","null"]},"rank":{"description":"domain rank on the given date
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"number of referring domains
referring domains include subdomains that are counted as separate domains for this metric","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and link count per each semantic location
you can get the full list of semantic elements here
examples:article, section, summary","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top-level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_pages":{"description":"number of pages pointing to the target","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksHistoryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksHistoryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksHistoryLiveResultInfo":{"properties":{"date_from":{"description":"starting date of the time range
in the UTC format: “yyyy-mm-dd”
example:2019-01-01","type":["string","null"]},"date_to":{"description":"ending date of the time range
in the UTC format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"items":{"description":"contains historical backlink data for the specified domain
the data is provided month-by-month;
the metrics are aggregated according to the backlinks the specified domain had on the first day of each given month","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksHistoryLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"target":{"description":"target from the POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksHistoryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksHistoryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksIndexResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksIndexTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksIndexResultInfo":{"properties":{"index_history":{"description":"index volume data for the past 12 months","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_IndexHistory"}],"type":["object","null"]},"type":["array","null"]},"total_backlinks":{"description":"total number of backlinks our database contains for the moment of checking","format":"int64","type":["integer","null"]},"total_pages":{"description":"total number of pages our database contains for the moment of checking","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksIndexTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksIndexResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksInfo":{"properties":{"backlinks":{"description":"average number of backlinks","format":"int64","type":["integer","null"]},"dofollow":{"description":"average number of dofollow links","format":"int64","type":["integer","null"]},"referring_domains":{"description":"average number of referring domains","format":"int64","type":["integer","null"]},"referring_main_domains":{"description":"average number of referring main domains","format":"int64","type":["integer","null"]},"referring_pages":{"description":"average number of referring pages","format":"int64","type":["integer","null"]},"time_update":{"description":"date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksPageIntersection":{"properties":{"alt":{"description":"alternative text of the image
this field will be null if backlink type is not image","type":["string","null"]},"anchor":{"description":"anchor text of the backlink","type":["string","null"]},"attributes":{"description":"link attributes of the referring links
example:nofollow","items":{"type":["string","null"]},"type":["array","null"]},"backlink_spam_score":{"description":"spam score of the backlink
learn more about how the metric is calculated on this help center page","type":["integer","null"]},"dofollow":{"description":"indicates whether the backlink is dofollow
if false, the backlink is nofollow","type":["boolean","null"]},"domain_from":{"description":"domain referring to the target domain or webpage","type":["string","null"]},"domain_from_country":{"description":"ISO country code of the referring domain","type":["string","null"]},"domain_from_ip":{"description":"IP address of the referring domain","type":["string","null"]},"domain_from_is_ip":{"description":"indicates if the domain is IP
if true, the domain functions as an IP address and does not have a domain name","type":["boolean","null"]},"domain_from_platform_type":{"description":"platform types of the referring domaincms, blogs, ecommerce, message-boards, wikis, news, organization","items":{"type":["string","null"]},"type":["array","null"]},"domain_from_rank":{"description":"domain rank of the referring domain
indicates the rank of the domain at the time our crawler last saw the backlink;domain_from_rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"domain_to":{"description":"domain the backlink is pointing to","type":["string","null"]},"first_seen":{"description":"date and time when our crawler found the backlink for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"group_count":{"description":"indicates total number of backlinks from this domain
for example, if mode is set to one_per_domain, this field will indicate the total number of backlinks coming from this domain","format":"int64","type":["integer","null"]},"indirect_link_path":{"description":"indirect link path
indicates a URL or a sequence of URLs that lead to url_to","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksRedirectInfo"}],"type":["object","null"]},"type":["array","null"]},"is_broken":{"description":"indicates whether the backlink is broken
if true, the backlink is pointing to a page responding with a 4xx or 5xx status code","type":["boolean","null"]},"is_indirect_link":{"description":"indicates whether the backlink is an indirect link
if true, the backlink is an indirect link pointing to a page that either redirects to url_to, or points to a canonical page","type":["boolean","null"]},"is_lost":{"description":"indicates whether the backlink was removed
if true, the backlink or the entire page was removed","type":["boolean","null"]},"is_new":{"description":"indicates whether the backlink is new
if true, the backlink was found on the page last time our crawler visited it","type":["boolean","null"]},"item_type":{"description":"link type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["string","null"]},"last_seen":{"description":"most recent date when our crawler visited the backlink
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"links_count":{"description":"number of identical backlinks found on the referring page","format":"int64","type":["integer","null"]},"original":{"description":"indicates whether the backlink was present on the referring page when our crawler first visited it","type":["boolean","null"]},"page_from_encoding":{"description":"character encoding of the referring page
example:utf-8","type":["string","null"]},"page_from_external_links":{"description":"number of external links found on the referring page","type":["integer","null"]},"page_from_internal_links":{"description":"number of internal links found on the referring page","type":["integer","null"]},"page_from_language":{"description":"language of the referring page
in ISO 639-1 format
example:en","type":["string","null"]},"page_from_rank":{"description":"page rank of the referring pagepage_from_rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"page_from_size":{"description":"size of the referring page, in bytes
example:63357","type":["integer","null"]},"page_from_status_code":{"description":"HTTP status code returned by the referring page
example:200","type":["integer","null"]},"page_from_title":{"description":"title of the referring page","type":["string","null"]},"prev_seen":{"description":"previous to the most recent date when our crawler visited the backlink
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"backlink rankrank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"semantic_location":{"description":"indicates semantic element in HTML where the backlink is found
you can get the full list of semantic elements here
examples:article, section, summary","type":["string","null"]},"text_post":{"description":"snippet after the anchor text","type":["string","null"]},"text_pre":{"description":"text snippet before the anchor text","type":["string","null"]},"tld_from":{"description":"top-level domain of the referring URL","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url_from":{"description":"URL of the page where the backlink is found","type":["string","null"]},"url_from_https":{"description":"indicates whether the referring URL is secured with HTTPS
if true, the referring URL is secured with HTTPS","type":["boolean","null"]},"url_to":{"description":"URL the backlink is pointing to","type":["string","null"]},"url_to_https":{"description":"indicates if the URL the backlink is pointing to is secured with HTTPS
if true, the URL is secured with HTTPS","type":["boolean","null"]},"url_to_redirect_target":{"description":"target url of the redirect
target page the redirect is pointing to","type":["string","null"]},"url_to_spam_score":{"description":"spam score of the referenced page
if the value is null, our crawler hasn't yet visited the webpage the link is pointing to
learn more about how the metric is calculated on this help center page","type":["integer","null"]},"url_to_status_code":{"description":"status code of the referenced page
if the value is null, our crawler hasn't yet visited the webpage the link is pointing to
example:200","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksPageIntersectionLiveItem":{"properties":{"page_intersection":{"additionalProperties":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksPageIntersection"}],"type":["object","null"]},"type":["array","null"]},"description":"contains data on pages that link to the corresponding targets specified in the POST array
data is provided in separate objects corresponding to pages specified in the targets object","type":["object","null"]},"summary":{"description":"contains the page intersections summary","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_IntersectionSummaryInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_BacklinksPageIntersectionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksPageIntersectionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksPageIntersectionLiveResultInfo":{"properties":{"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksPageIntersectionLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"targets":{"additionalProperties":{"type":["string","null"]},"description":"targets from a POST array","type":["object","null"]},"total_count":{"description":"total amount of results relevant the request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksPageIntersectionLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksPageIntersectionLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksPageMeta":{"properties":{"canonical":{"description":"canonical page","type":["string","null"]},"charset":{"description":"character encoding
examples:utf-8","type":["string","null"]},"external_links_count":{"description":"number of external links on the page","format":"int64","type":["integer","null"]},"h1":{"description":"h1 tag
content of h1 tags","items":{"type":["string","null"]},"type":["array","null"]},"h2":{"description":"h2 tag
content of h2 tags","items":{"type":["string","null"]},"type":["array","null"]},"h3":{"description":"h3 tag
content of h3 tags","items":{"type":["string","null"]},"type":["array","null"]},"images_alt":{"description":"content of alt tags","items":{"type":["string","null"]},"type":["array","null"]},"images_count":{"description":"number of images on the page","format":"int64","type":["integer","null"]},"internal_links_count":{"description":"number of internal links on the page","format":"int64","type":["integer","null"]},"language":{"description":"page content language
example:en","type":["string","null"]},"page_spam_score":{"description":"spam score of the page
learn more about how the metric is calculated on this help center page","type":["integer","null"]},"platform_type":{"description":"type of a platform","items":{"type":["string","null"]},"type":["array","null"]},"powered_by":{"description":"CMS details","items":{"type":["string","null"]},"type":["array","null"]},"social_media_tags":{"additionalProperties":{"type":["string","null"]},"description":"array of social media tags found on the page
contains social media tags and their content
supported tags include but are not limited to Open Graph and Twitter card","type":["object","null"]},"technologies":{"additionalProperties":{"type":["string","null"]},"description":"website technologies","type":["object","null"]},"title":{"description":"page title","type":["string","null"]},"words_count":{"description":"number of words on the page","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksRedirectInfo":{"properties":{"status_code":{"description":"general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"indirect link URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksReferringDomainsLiveItem":{"properties":{"backlinks":{"description":"indicates the number of backlinks pointing to the target","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"average spam score of all backlinks pointing to the domain
learn more about how the metric is calculated on this help center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the domain","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that respond with 4xx or 5xx status codes where backlinks are pointing to","type":["integer","null"]},"domain":{"description":"referring domain","type":["string","null"]},"first_seen":{"description":"date and time when our crawler found the backlink for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink from this domain was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"rank":{"description":"domain rank
rank volume that a referring website passes to the targetrank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number of referring domains
note that we calculate main domains (root domains, like example.com) and their subdomains (e.g. blog.example.com) separately for this metric","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and the link count per each semantic location
examples:article, section, summary","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains
the number of primary (root) domains referring to your target","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the target specified","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksReferringDomainsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksReferringDomainsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksReferringDomainsLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksReferringDomainsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the items array","format":"int64","type":["integer","null"]},"target":{"description":"target in a POST array","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database
total number of main domains referring to your target;
example.com and blog.example.com are counted as one referring domain","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksReferringDomainsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksReferringDomainsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksReferringNetworksLiveItem":{"properties":{"backlinks":{"description":"indicates the number of backlinks pointing to the target","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the domain","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that respond with 4xx or 5xx status codes where backlinks are pointing to","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found the backlink for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink from this domain was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"network_address":{"description":"address of the referring subnetwork or IP","type":["string","null"]},"rank":{"description":"network rank
rank volume that a referring network passes to the targetrank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number of referring domains
referring domains include subdomains that are counted as separate domains for this metric","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and the link count per each semantic location
examples:article, section, summary","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the target specified","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksReferringNetworksLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksReferringNetworksLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksReferringNetworksLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksReferringNetworksLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the items array","format":"int64","type":["integer","null"]},"target":{"description":"target in a POST array","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BacklinksReferringNetworksLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksReferringNetworksLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksSummaryLiveResultInfo":{"properties":{"backlinks":{"description":"indicates the number of backlinks","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"spam score of the backlinks
displays the total spam score of all backlinks pointing to the target domain, subdomain, or webpage;
to learn more about how the metric is calculated, refer to this Help Center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the target","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages on the target that respond with 4xx or 5xx status codestarget discovered by following external links, but it may also include pages discovered by following the target's sitemap","type":["integer","null"]},"crawled_pages":{"description":"number of crawled pages for the target","type":["integer","null"]},"external_links_count":{"description":"number of external links on the page
calculated as the sum of external links on the pages of the specified target","format":"int64","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found the backlink for the target for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"info":{"description":"information about the target","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TargetInfo"}],"type":["object","null"]},"internal_links_count":{"description":"number of internal links
calculated as the sum of internal links on the pages of the specified target","format":"int64","type":["integer","null"]},"lost_date":{"description":"date and time when the backlink was lost
indicates the date and time when our crawler visited the target and it responded with a 4xx or 5xx status code or when its last backlink was removed
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"target rank
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number of referring domains
referring domains include subdomains that are counted as separate domains for this metric","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute
example values:nofollow, noopener, noreferrer, external, ugc, sponsored","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and link count per each semantic location
example values:article, section, summary, \"\"","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the target","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]},"target":{"description":"target in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksSummaryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveItem":{"properties":{"date":{"description":"date and time when the data for the target was stored
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_backlinks":{"description":"number of lost backlinks
number of lost backlinks of the target","format":"int64","type":["integer","null"]},"lost_referring_domains":{"description":"number of lost referring domains
number of lost referring domains of the target","format":"int64","type":["integer","null"]},"lost_referring_main_domains":{"description":"number of lost referring main domains
number of lost referring main domains of the target","format":"int64","type":["integer","null"]},"new_backlinks":{"description":"number of new backlinks
number of new backlinks pointing to the target","format":"int64","type":["integer","null"]},"new_referring_domains":{"description":"number of new referring domains
number of new referring domains pointing to the target","format":"int64","type":["integer","null"]},"new_referring_main_domains":{"description":"number of new referring main domains
number of new referring main domains pointing to the target","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveResultInfo":{"properties":{"date_from":{"description":"starting date of the time range
in the UTC format: “yyyy-mm-dd”
example:2019-01-01","type":["string","null"]},"date_to":{"description":"ending date of the time range
in the UTC format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"group_range":{"description":"group_range from the POST array","type":["string","null"]},"items":{"description":"contains relevant backlinks and referring domains data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"target":{"description":"target from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksTimeseriesNewLostSummaryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksTimeseriesSummaryLiveItem":{"properties":{"backlinks":{"description":"number of backlinks for the given date","format":"int64","type":["integer","null"]},"backlinks_nofollow":{"description":"number of nofollow backlinks for the given date","format":"int64","type":["integer","null"]},"date":{"description":"date and time when the data for the target was stored
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"target rank for the given date
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"number of referring domains for the given date
referring domains include subdomains that are counted as separate domains for this metric","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the target for the given date","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses for the given date
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_main_domains":{"description":"number of referring main domains for the given date","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the target for the given date","format":"int64","type":["integer","null"]},"referring_pages":{"description":"number of pages pointing to target for the given date","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the target for the given date","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks for the given date","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksTimeseriesSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksTimeseriesSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BacklinksTimeseriesSummaryLiveResultInfo":{"properties":{"date_from":{"description":"starting date of the time range
in the UTC format: “yyyy-mm-dd”
example:2019-01-01","type":["string","null"]},"date_to":{"description":"ending date of the time range
in the UTC format: \"yyyy-mm-dd\"
example:\"2019-01-15\"","type":["string","null"]},"group_range":{"description":"group_range from a POST array","type":["string","null"]},"items":{"description":"contains relevant summary data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksTimeseriesSummaryLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"target":{"description":"target from a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BacklinksTimeseriesSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksTimeseriesSummaryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"message":"#/components/schemas/Response0A3E90081762_MessageAiOptimizationLlmResponseElementItem","reasoning":"#/components/schemas/Response0A3E90081762_ReasoningAiOptimizationLlmResponseElementItem"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseBingSerpApiElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"ai_overview":"#/components/schemas/Response0A3E90081762_BingAiOverviewSerpElementItem","answer_box":"#/components/schemas/Response0A3E90081762_BingAnswerBoxSerpElementItem","carousel":"#/components/schemas/Response0A3E90081762_BingCarouselSerpElementItem","events":"#/components/schemas/Response0A3E90081762_BingEventsSerpElementItem","featured_snippet":"#/components/schemas/Response0A3E90081762_BingFeaturedSnippetSerpElementItem","hotels_pack":"#/components/schemas/Response0A3E90081762_BingHotelsPackSerpElementItem","images":"#/components/schemas/Response0A3E90081762_BingImagesSerpElementItem","jobs":"#/components/schemas/Response0A3E90081762_BingJobsSerpElementItem","local_pack":"#/components/schemas/Response0A3E90081762_BingLocalPackSerpElementItem","map":"#/components/schemas/Response0A3E90081762_BingMapSerpElementItem","organic":"#/components/schemas/Response0A3E90081762_BingOrganicSerpElementItem","paid":"#/components/schemas/Response0A3E90081762_BingPaidSerpElementItem","people_also_ask":"#/components/schemas/Response0A3E90081762_BingPeopleAlsoAskSerpElementItem","people_also_search":"#/components/schemas/Response0A3E90081762_BingPeopleAlsoSearchSerpElementItem","questions_and_answers":"#/components/schemas/Response0A3E90081762_BingQuestionsAndAnswersSerpElementItem","recipes":"#/components/schemas/Response0A3E90081762_BingRecipesSerpElementItem","related_searches":"#/components/schemas/Response0A3E90081762_BingRelatedSearchesSerpElementItem","shopping":"#/components/schemas/Response0A3E90081762_BingShoppingSerpElementItem","top_stories":"#/components/schemas/Response0A3E90081762_BingTopStoriesSerpElementItem","video":"#/components/schemas/Response0A3E90081762_BingVideoSerpElementItem"},"propertyName":"type"},"properties":{"page":{"description":"search results page number
indicates the number of the SERP page on which the element is located","type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:
left, right","type":["string","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseChatGptLlmScraperElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"chat_gpt_ad":"#/components/schemas/Response0A3E90081762_ChatGptAdElementItem","chat_gpt_images":"#/components/schemas/Response0A3E90081762_ChatGptImagesElementItem","chat_gpt_local_businesses":"#/components/schemas/Response0A3E90081762_ChatGptLocalBusinessesElementItem","chat_gpt_navigation_list":"#/components/schemas/Response0A3E90081762_ChatGptNavigationListElementItem","chat_gpt_products":"#/components/schemas/Response0A3E90081762_ChatGptProductsElementItem","chat_gpt_table":"#/components/schemas/Response0A3E90081762_ChatGptTableElementItem","chat_gpt_text":"#/components/schemas/Response0A3E90081762_ChatGptTextElementItem"},"propertyName":"type"},"properties":{"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseDataforseoLabsApiElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"answer_box":"#/components/schemas/Response0A3E90081762_DataLabsAnswerBoxSerpElementItem","carousel":"#/components/schemas/Response0A3E90081762_DataLabsCarouselSerpElementItem","commercial_units":"#/components/schemas/Response0A3E90081762_DataLabsCommercialUnitsSerpElementItem","courses":"#/components/schemas/Response0A3E90081762_DataLabsCoursesSerpElementItem","events":"#/components/schemas/Response0A3E90081762_DataLabsEventsSerpElementItem","explore_brands":"#/components/schemas/Response0A3E90081762_DataLabsExploreBrandsSerpElementItem","featured_snippet":"#/components/schemas/Response0A3E90081762_DataLabsFeaturedSnippetSerpElementItem","find_results_on":"#/components/schemas/Response0A3E90081762_DataLabsFindResultsOnSerpElementItem","found_on_web":"#/components/schemas/Response0A3E90081762_DataLabsFoundOnWebSerpElementItem","google_flights":"#/components/schemas/Response0A3E90081762_DataLabsGoogleFlightsSerpElementItem","google_hotels":"#/components/schemas/Response0A3E90081762_DataLabsGoogleHotelsSerpElementItem","google_posts":"#/components/schemas/Response0A3E90081762_DataLabsGooglePostsSerpElementItem","google_reviews":"#/components/schemas/Response0A3E90081762_DataLabsGoogleReviewsSerpElementItem","hotels_pack":"#/components/schemas/Response0A3E90081762_DataLabsHotelsPackSerpElementItem","images":"#/components/schemas/Response0A3E90081762_DataLabsImagesSerpElementItem","jobs":"#/components/schemas/Response0A3E90081762_DataLabsJobsSerpElementItem","knowledge_graph":"#/components/schemas/Response0A3E90081762_DataLabsKnowledgeGraphSerpElementItem","local_pack":"#/components/schemas/Response0A3E90081762_DataLabsLocalPackSerpElementItem","local_services":"#/components/schemas/Response0A3E90081762_DataLabsLocalServicesSerpElementItem","map":"#/components/schemas/Response0A3E90081762_DataLabsMapSerpElementItem","math_solver":"#/components/schemas/Response0A3E90081762_DataLabsMathSolverSerpElementItem","mention_carousel":"#/components/schemas/Response0A3E90081762_DataLabsMentionCarouselSerpElementItem","multi_carousel":"#/components/schemas/Response0A3E90081762_DataLabsMultiCarouselSerpElementItem","organic":"#/components/schemas/Response0A3E90081762_DataLabsOrganicSerpElementItem","paid":"#/components/schemas/Response0A3E90081762_DataLabsPaidSerpElementItem","people_also_ask":"#/components/schemas/Response0A3E90081762_DataLabsPeopleAlsoAskSerpElementItem","people_also_search":"#/components/schemas/Response0A3E90081762_DataLabsPeopleAlsoSearchSerpElementItem","podcasts":"#/components/schemas/Response0A3E90081762_DataLabsPodcastsSerpElementItem","popular_products":"#/components/schemas/Response0A3E90081762_DataLabsPopularProductsSerpElementItem","questions_and_answers":"#/components/schemas/Response0A3E90081762_DataLabsQuestionsAndAnswersSerpElementItem","recipes":"#/components/schemas/Response0A3E90081762_DataLabsRecipesSerpElementItem","related_searches":"#/components/schemas/Response0A3E90081762_DataLabsRelatedSearchesSerpElementItem","scholarly_articles":"#/components/schemas/Response0A3E90081762_DataLabsScholarlyArticlesSerpElementItem","shopping":"#/components/schemas/Response0A3E90081762_DataLabsShoppingSerpElementItem","stocks_box":"#/components/schemas/Response0A3E90081762_DataLabsStocksBoxSerpElementItem","top_sights":"#/components/schemas/Response0A3E90081762_DataLabsTopSightsSerpElementItem","top_stories":"#/components/schemas/Response0A3E90081762_DataLabsTopStoriesSerpElementItem","twitter":"#/components/schemas/Response0A3E90081762_DataLabsTwitterSerpElementItem","video":"#/components/schemas/Response0A3E90081762_DataLabsVideoSerpElementItem","visual_stories":"#/components/schemas/Response0A3E90081762_DataLabsVisualStoriesSerpElementItem"},"propertyName":"type"},"properties":{"position":{"description":"the alignment of the element in SERP
can take the following values:
left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"knowledge_graph_carousel_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphCarouselItemElementItem","knowledge_graph_description_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphDescriptionItemElementItem","knowledge_graph_expanded_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphExpandedItemElementItem","knowledge_graph_images_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphImagesItemElementItem","knowledge_graph_list_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphListItemElementItem","knowledge_graph_part_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphPartItemElementItem","knowledge_graph_row_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphRowItemElementItem","knowledge_graph_shopping_item":"#/components/schemas/Response0A3E90081762_DataforseoLabsKnowledgeGraphShoppingItemElementItem"},"propertyName":"type"},"properties":{"position":{"description":"the alignment of the element in SERP
can take the following values:
left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseGeminiLlmScraperElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"gemini_images":"#/components/schemas/Response0A3E90081762_GeminiImagesElementItem","gemini_table":"#/components/schemas/Response0A3E90081762_GeminiTableElementItem","gemini_text":"#/components/schemas/Response0A3E90081762_GeminiTextElementItem"},"propertyName":"type"},"properties":{"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseKeywordDataDataforseoTrendsItem":{"additionalProperties":false,"discriminator":{"mapping":{"dataforseo_trends_graph":"#/components/schemas/Response0A3E90081762_DataforseoTrendsDataforseoTrendsGraphElementItem","demography":"#/components/schemas/Response0A3E90081762_DataforseoTrendsDemographyElementItem","subregion_interests":"#/components/schemas/Response0A3E90081762_DataforseoTrendsSubregionInterestsElementItem"},"propertyName":"type"},"properties":{"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element
can take the following values: 1, 2, 3, 4, etc.","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseKeywordDataGoogleTrendsItem":{"additionalProperties":false,"discriminator":{"mapping":{"google_trends_graph":"#/components/schemas/Response0A3E90081762_GoogleTrendsGoogleTrendsGraphElementItem","google_trends_map":"#/components/schemas/Response0A3E90081762_GoogleTrendsGoogleTrendsMapElementItem","google_trends_queries_list":"#/components/schemas/Response0A3E90081762_GoogleTrendsGoogleTrendsQueriesListElementItem","google_trends_topics_list":"#/components/schemas/Response0A3E90081762_GoogleTrendsGoogleTrendsTopicsListElementItem"},"propertyName":"type"},"properties":{"keywords":{"description":"relevant keywords
the data included in the google_trends_graph element is based on the keywords listed in this array","items":{"type":["string","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in Google Trends
can take the following values: 1, 2, 3, 4, etc.","type":["integer","null"]},"title":{"description":"title of the element in Google Trends","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseLocalBusinessLink":{"additionalProperties":false,"discriminator":{"mapping":{"menu":"#/components/schemas/Response0A3E90081762_LocalBusinessMenuLink","order":"#/components/schemas/Response0A3E90081762_LocalBusinessOrderLink","reservation":"#/components/schemas/Response0A3E90081762_LocalBusinessReservationLink"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseMerchantAmazonElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"amazon_paid":"#/components/schemas/Response0A3E90081762_MerchantAmazonPaidSerpElementItem","amazon_serp":"#/components/schemas/Response0A3E90081762_MerchantAmazonSerpSerpElementItem","editorial_recommendations":"#/components/schemas/Response0A3E90081762_MerchantEditorialRecommendationsSerpElementItem","related_searches":"#/components/schemas/Response0A3E90081762_MerchantRelatedSearchesSerpElementItem","top_rated_from_our_brands":"#/components/schemas/Response0A3E90081762_MerchantTopRatedFromOurBrandsSerpElementItem"},"propertyName":"type"},"properties":{"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements found in Amazon SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseMerchantAmazonProductInformationElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"product_information_details_item":"#/components/schemas/Response0A3E90081762_ProductInformationProductInformationDetailsItem","product_information_extended_item":"#/components/schemas/Response0A3E90081762_ProductInformationProductInformationExtendedItem","product_information_text_item":"#/components/schemas/Response0A3E90081762_ProductInformationProductInformationTextItem"},"propertyName":"type"},"properties":{"section_name":{"description":"name of the section related to product information specified in the contents","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseMerchantAmazonProductInformationRowElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"product_information_image_row":"#/components/schemas/Response0A3E90081762_ProductInformationRowProductInformationImageRowElementItem","product_information_text_row":"#/components/schemas/Response0A3E90081762_ProductInformationRowProductInformationTextRowElementItem"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseMerchantAmazonSellersElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"amazon_seller_item":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellerItemSerpElementItem","amazon_seller_main_item":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellerMainItemSerpElementItem"},"propertyName":"type"},"properties":{"applicable_vouchers":{"description":"array of objects containing information about applicable vouchers","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonApplicableVouchersItem"}],"type":["object","null"]},"type":["array","null"]},"condition":{"description":"product condition
condition of the product offered by the seller","type":["string","null"]},"condition_description":{"description":"product condition details
expanded details on the condition of the product offered by the seller","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonDeliveryInfo"}],"type":["object","null"]},"percentage_discount":{"description":"value of the percentage discount","type":["number","null"]},"position":{"description":"alignment of the element in SERP
possible values:left, right","type":["string","null"]},"price":{"description":"product pricing details
if there are no details, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements found in Amazon Sellers SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"seller rating details
seller popularity rate based on customer reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"seller_name":{"description":"business name of the seller","type":["string","null"]},"seller_url":{"description":"url forwarding to the seller's page on Amazon","type":["string","null"]},"ships_from":{"description":"sender company name","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"google_shopping_carousel":"#/components/schemas/Response0A3E90081762_GoogleShoppingCarouselElementItem","google_shopping_paid":"#/components/schemas/Response0A3E90081762_GoogleShoppingPaidElementItem","google_shopping_serp":"#/components/schemas/Response0A3E90081762_GoogleShoppingSerpElementItem","google_shopping_sponsored_carousel":"#/components/schemas/Response0A3E90081762_GoogleShoppingSponsoredCarouselElementItem","related_searches":"#/components/schemas/Response0A3E90081762_RelatedSearchesElementItem"},"propertyName":"type"},"properties":{"position":{"description":"alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements found in Google Shopping SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseMerchantGoogleShoppingSellersElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"buy_on_google":"#/components/schemas/Response0A3E90081762_GoogleShoppingSellersBuyOnGoogleElementItem","shops_list":"#/components/schemas/Response0A3E90081762_GoogleShoppingSellersShopsListElementItem"},"propertyName":"type"},"properties":{"base_price":{"description":"product price without tax and shipping","type":["number","null"]},"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"details":{"description":"details and special offers
if there are no details, the value will be null","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"position":{"description":"the alignment of the element in Google Shopping SERP
possible values:left, right","type":["string","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements found in Google Shopping SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"seller_name":{"description":"name of the seller
the name of the company that placed a corresponding product on Google Shopping","type":["string","null"]},"shipping_price":{"description":"product shipping price","type":["number","null"]},"shop_ad_aclk":{"description":"unique ad click referral parameter
using this parameter you can get a URL of the advertisement in Google Shopping Sellers Ad URL","type":["string","null"]},"tax":{"description":"the amount of tax
tax is specified as the actual amount of money, not as the percentage","type":["number","null"]},"title":{"description":"product title","type":["string","null"]},"total_price":{"description":"product price including tax and shipping","format":"int64","type":["number","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"Google Shopping URL forwarding to the product page on the seller’s website
if you want to obtain a URL of the advertisement forwarding to the product page on the seller's website, please refer to the Google Shopping Sellers Ad URL endpoint","type":["string","null"]},"xpath":{"description":"XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseOnPageLinkItem":{"additionalProperties":false,"discriminator":{"mapping":{"alternate":"#/components/schemas/Response0A3E90081762_OnPageAlternateLinkItem","anchor":"#/components/schemas/Response0A3E90081762_OnPageAnchorLinkItem","canonical":"#/components/schemas/Response0A3E90081762_OnPageCanonicalLinkItem","image":"#/components/schemas/Response0A3E90081762_OnPageImageLinkItem","link":"#/components/schemas/Response0A3E90081762_OnPageLinkLinkItem","meta":"#/components/schemas/Response0A3E90081762_OnPageMetaLinkItem","redirect":"#/components/schemas/Response0A3E90081762_OnPageRedirectLinkItem"},"propertyName":"type"},"properties":{"direction":{"description":"direction of the link
possible values: internal, external","type":["string","null"]},"dofollow":{"description":"indicates whether the link is dofollow
if the value is true, the link doesn't have a rel=\"nofollow\" attribute","type":["boolean","null"]},"domain_from":{"description":"referring domain
the link was found on this domain","type":["string","null"]},"domain_to":{"description":"referenced domain
the link is pointing to this domain","type":["string","null"]},"is_broken":{"description":"link is broken
indicates whether a link is directing to a broken page or resource","type":["boolean","null"]},"is_link_relation_conflict":{"description":"indicates that the link may have a conflict with another link
if true, at least one link pointing to link_to has a rel=\"nofollow\" attribute and at least one is dofollow","type":["boolean","null"]},"link_from":{"description":"referring page
absolute URL of the page on which the link was found","type":["string","null"]},"link_to":{"description":"referenced page
absolute URL of the page to which the link is pointing","type":["string","null"]},"page_from":{"description":"referring page
relative URL of the page on which the link was found","type":["string","null"]},"page_from_scheme":{"description":"url scheme of the referring page","type":["string","null"]},"page_to":{"description":"referenced page
relative URL of the page to which the link is pointing","type":["string","null"]},"page_to_scheme":{"description":"url scheme of the referenced page","type":["string","null"]},"page_to_status_code":{"description":"status code of the referenced page
status code of the page to which the link is pointing","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseOnPageResourceItem":{"additionalProperties":false,"discriminator":{"mapping":{"broken":"#/components/schemas/Response0A3E90081762_OnPageBrokenResourceItem","html":"#/components/schemas/Response0A3E90081762_OnPageHtmlResourceItem","image":"#/components/schemas/Response0A3E90081762_OnPageImageResourceItem","redirect":"#/components/schemas/Response0A3E90081762_OnPageRedirectResourceItem","script":"#/components/schemas/Response0A3E90081762_OnPageScriptResourceItem","stylesheet":"#/components/schemas/Response0A3E90081762_OnPageStylesheetResourceItem"},"propertyName":"resource_type"},"properties":{"cache_control":{"description":"instructions for caching","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CacheControl"}],"type":["object","null"]},"checks":{"additionalProperties":{"type":["boolean","null"]},"description":"website checkson-page check-ups related to the page","type":["object","null"]},"content_encoding":{"description":"type of encoding","type":["string","null"]},"encoded_size":{"description":"page size after encodingindicates the size of the encoded page measured in bytes","type":["integer","null"]},"fetch_time":{"description":"date and time when a resource was fetchedin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"last_modified":{"description":"contains data on changes related to the resourceif there is no data, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LastModified"}],"type":["object","null"]},"location":{"description":"location headerindicates the URL to redirect a page to","type":["string","null"]},"media_type":{"description":"types of media used to display a page","type":["string","null"]},"resource_errors":{"description":"resource errors and warnings","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourceIssueInfo"}],"type":["object","null"]},"resource_type":{"description":"type of element","type":["string","null"]},"server":{"description":"server version","type":["string","null"]},"size":{"description":"resource sizeindicates the size of a given page measured in bytes","type":["integer","null"]},"status_code":{"description":"general status codeyou can find the full list of the response codes hereNote: we strongly recommend designing a necessary system for handling related exceptional or error conditions","type":["integer","null"]},"total_transfer_size":{"description":"compressed page sizeindicates the compressed size of a given page","format":"int64","type":["integer","null"]},"url":{"description":"page URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseResponseInfo":{"properties":{"cost":{"description":"total tasks cost, USD","format":"double","type":["number","null"]},"status_code":{"description":"general status code\nyou can find the full list of the response codes here","type":["integer","null"]},"status_message":{"description":"general informational message\nyou can find the full list of general informational messages here","type":["string","null"]},"tasks_count":{"description":"the number of tasks in the tasks array","format":"int64","type":["integer","null"]},"tasks_error":{"description":"the number of tasks in the tasks array returned with an error","format":"int64","type":["integer","null"]},"time":{"description":"total execution time, seconds","type":["string","null"]},"version":{"description":"the current version of the API","type":["string","null"]}}},"Response0A3E90081762_BaseResponseTaskInfo":{"properties":{"cost":{"description":"total tasks cost, USD","format":"double","type":["number","null"]},"data":{"additionalProperties":{"type":["object","null"]},"description":"contains the same parameters that you specified in the POST request","type":["object","null"]},"id":{"description":"task identifier\nunique task identifier in our system in the UUID format","type":["string","null"]},"path":{"description":"URL path","items":{"type":["string","null"]},"type":["array","null"]},"result_count":{"description":"number of elements in the result array","format":"int64","type":["integer","null"]},"status_code":{"description":"status code of the task\ngenerated by DataForSEO, can be within the following range: 10000-60000\nyou can find the full list of the response codes here","type":["integer","null"]},"status_message":{"description":"informational message of the task\nyou can find the full list of general informational messages here","type":["string","null"]},"time":{"description":"execution time, seconds","type":["string","null"]}}},"Response0A3E90081762_BaseSerpApiAdsAdvertiserElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"ads_advertiser":"#/components/schemas/Response0A3E90081762_SerpApiAdsAdvertiserElementItem","ads_domain":"#/components/schemas/Response0A3E90081762_SerpApiAdsDomainElementItem","ads_multi_account_advertiser":"#/components/schemas/Response0A3E90081762_SerpApiAdsMultiAccountAdvertiserElementItem"},"propertyName":"type"},"properties":{"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"ai_overview_element":"#/components/schemas/Response0A3E90081762_SerpApiAiModeAiOverviewElementItem","ai_overview_expanded_element":"#/components/schemas/Response0A3E90081762_SerpApiAiModeAiOverviewExpandedElementItem","ai_overview_paid":"#/components/schemas/Response0A3E90081762_SerpApiAiModeAiOverviewPaidItem","ai_overview_shopping":"#/components/schemas/Response0A3E90081762_SerpApiAiModeAiOverviewShoppingItem","ai_overview_table_element":"#/components/schemas/Response0A3E90081762_SerpApiAiModeAiOverviewTableElementItem","ai_overview_video_element":"#/components/schemas/Response0A3E90081762_SerpApiAiModeAiOverviewVideoElementItem"},"propertyName":"type"},"properties":{"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiAiOverviewElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"ai_overview_element":"#/components/schemas/Response0A3E90081762_SerpApiAiOverviewElementItem","ai_overview_expanded_element":"#/components/schemas/Response0A3E90081762_SerpApiAiOverviewExpandedElementItem","ai_overview_table_element":"#/components/schemas/Response0A3E90081762_SerpApiAiOverviewTableElementItem","ai_overview_video_element":"#/components/schemas/Response0A3E90081762_SerpApiAiOverviewVideoElementItem"},"propertyName":"type"},"properties":{"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"ai_overview_element":"#/components/schemas/Response0A3E90081762_SerpApiBingAiOverviewElementItem","ai_overview_images_element":"#/components/schemas/Response0A3E90081762_SerpApiBingAiOverviewImagesElementItem","ai_overview_organic_element":"#/components/schemas/Response0A3E90081762_SerpApiBingAiOverviewOrganicElementItem","ai_overview_video_element":"#/components/schemas/Response0A3E90081762_SerpApiBingAiOverviewVideoElementItem","ai_overview_videos_element":"#/components/schemas/Response0A3E90081762_SerpApiBingAiOverviewVideosElementItem"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"ai_overview":"#/components/schemas/Response0A3E90081762_AiOverviewSerpElementItem","answer_box":"#/components/schemas/Response0A3E90081762_AnswerBoxSerpElementItem","app":"#/components/schemas/Response0A3E90081762_AppSerpElementItem","carousel":"#/components/schemas/Response0A3E90081762_CarouselSerpElementItem","commercial_units":"#/components/schemas/Response0A3E90081762_CommercialUnitsSerpElementItem","compare_sites":"#/components/schemas/Response0A3E90081762_CompareSitesSerpElementItem","courses":"#/components/schemas/Response0A3E90081762_CoursesSerpElementItem","currency_box":"#/components/schemas/Response0A3E90081762_CurrencyBoxSerpElementItem","dictionary":"#/components/schemas/Response0A3E90081762_DictionarySerpElementItem","discussions_and_forums":"#/components/schemas/Response0A3E90081762_DiscussionsAndForumsSerpElementItem","events":"#/components/schemas/Response0A3E90081762_EventsSerpElementItem","explore_brands":"#/components/schemas/Response0A3E90081762_ExploreBrandsSerpElementItem","featured_snippet":"#/components/schemas/Response0A3E90081762_FeaturedSnippetSerpElementItem","find_results_on":"#/components/schemas/Response0A3E90081762_FindResultsOnSerpElementItem","found_on_web":"#/components/schemas/Response0A3E90081762_FoundOnWebSerpElementItem","google_flights":"#/components/schemas/Response0A3E90081762_GoogleFlightsSerpElementItem","google_hotels":"#/components/schemas/Response0A3E90081762_GoogleHotelsSerpElementItem","google_posts":"#/components/schemas/Response0A3E90081762_GooglePostsSerpElementItem","google_reviews":"#/components/schemas/Response0A3E90081762_GoogleReviewsSerpElementItem","hotels_pack":"#/components/schemas/Response0A3E90081762_HotelsPackSerpElementItem","images":"#/components/schemas/Response0A3E90081762_ImagesSerpElementItem","jobs":"#/components/schemas/Response0A3E90081762_JobsSerpElementItem","knowledge_graph":"#/components/schemas/Response0A3E90081762_KnowledgeGraphSerpElementItem","knowledge_graph_ai_overview_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphAiOverviewItemSerpElementItem","knowledge_graph_carousel_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphCarouselItemSerpElementItem","knowledge_graph_description_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphDescriptionItemSerpElementItem","knowledge_graph_expanded_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphExpandedItemSerpElementItem","knowledge_graph_hotels_booking_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphHotelsBookingItemSerpElementItem","knowledge_graph_images_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphImagesItemSerpElementItem","knowledge_graph_list_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListItemSerpElementItem","knowledge_graph_part_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphPartItemSerpElementItem","knowledge_graph_row_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphRowItemSerpElementItem","knowledge_graph_shopping_item":"#/components/schemas/Response0A3E90081762_KnowledgeGraphShoppingItemSerpElementItem","local_pack":"#/components/schemas/Response0A3E90081762_LocalPackSerpElementItem","local_services":"#/components/schemas/Response0A3E90081762_LocalServicesSerpElementItem","map":"#/components/schemas/Response0A3E90081762_MapSerpElementItem","math_solver":"#/components/schemas/Response0A3E90081762_MathSolverSerpElementItem","mention_carousel":"#/components/schemas/Response0A3E90081762_MentionCarouselSerpElementItem","multi_carousel":"#/components/schemas/Response0A3E90081762_MultiCarouselSerpElementItem","organic":"#/components/schemas/Response0A3E90081762_OrganicSerpElementItem","paid":"#/components/schemas/Response0A3E90081762_PaidSerpElementItem","people_also_ask":"#/components/schemas/Response0A3E90081762_PeopleAlsoAskSerpElementItem","people_also_search":"#/components/schemas/Response0A3E90081762_PeopleAlsoSearchSerpElementItem","perspectives":"#/components/schemas/Response0A3E90081762_PerspectivesSerpElementItem","podcasts":"#/components/schemas/Response0A3E90081762_PodcastsSerpElementItem","popular_products":"#/components/schemas/Response0A3E90081762_PopularProductsSerpElementItem","product_considerations":"#/components/schemas/Response0A3E90081762_ProductConsiderationsSerpElementItem","questions_and_answers":"#/components/schemas/Response0A3E90081762_QuestionsAndAnswersSerpElementItem","recipes":"#/components/schemas/Response0A3E90081762_RecipesSerpElementItem","refine_products":"#/components/schemas/Response0A3E90081762_RefineProductsSerpElementItem","related_searches":"#/components/schemas/Response0A3E90081762_RelatedSearchesSerpElementItem","scholarly_articles":"#/components/schemas/Response0A3E90081762_ScholarlyArticlesSerpElementItem","shopping":"#/components/schemas/Response0A3E90081762_ShoppingSerpElementItem","short_videos":"#/components/schemas/Response0A3E90081762_ShortVideosSerpElementItem","stocks_box":"#/components/schemas/Response0A3E90081762_StocksBoxSerpElementItem","third_party_reviews":"#/components/schemas/Response0A3E90081762_ThirdPartyReviewsSerpElementItem","top_sights":"#/components/schemas/Response0A3E90081762_TopSightsSerpElementItem","top_stories":"#/components/schemas/Response0A3E90081762_TopStoriesSerpElementItem","twitter":"#/components/schemas/Response0A3E90081762_TwitterSerpElementItem","video":"#/components/schemas/Response0A3E90081762_VideoSerpElementItem","visual_stories":"#/components/schemas/Response0A3E90081762_VisualStoriesSerpElementItem"},"propertyName":"type"},"properties":{"page":{"description":"search results page number
indicates the number of the SERP page on which the element is located","type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"google_finance_about":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceAboutElementItem","google_finance_asset_pair_element":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceAssetPairElementElementItem","google_finance_compare_to":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceCompareToElementItem","google_finance_details":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceDetailsElementItem","google_finance_earnings_calendar":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceEarningsCalendarElementItem","google_finance_explore_market_trends":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceExploreMarketTrendsElementItem","google_finance_financial":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceFinancialElementItem","google_finance_futures_chain":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceFuturesChainElementItem","google_finance_hero_groups":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceHeroGroupsElementItem","google_finance_interested":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceInterestedElementItem","google_finance_market_index_element":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceMarketIndexElementElementItem","google_finance_market_instrument_element":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceMarketInstrumentElementElementItem","google_finance_market_trends":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceMarketTrendsElementItem","google_finance_most_followed":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceMostFollowedElementItem","google_finance_news":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceNewsElementItem","google_finance_people_also_search":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinancePeopleAlsoSearchElementItem","google_finance_quote":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceQuoteElementItem"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiGoogleFinanceTickerSearchElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"google_finance_asset_pair":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceAssetPairElementItem","google_finance_market_index":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceMarketIndexElementItem","google_finance_market_instrument":"#/components/schemas/Response0A3E90081762_SerpApiGoogleFinanceMarketInstrumentElementItem"},"propertyName":"type"},"properties":{"displayed_name":{"description":"name of the market index as displayed on Google Finance
example: CAC 40","type":["string","null"]},"identifier":{"description":"identifier of the element
full identifier of the element that consists from ticker and market_identifier
example: PX1:INDEXDB","type":["string","null"]},"location":{"description":"location of the market index
example: Europe/Paris","type":["string","null"]},"percentage_delta":{"description":"percentage of change in value of the market index","type":["number","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"trend":{"description":"growth trend of the market index
possible values: up, down, stable","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the page of the market index on Google Finance","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiGoogleImagesElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"carousel":"#/components/schemas/Response0A3E90081762_SerpApiGoogleImagesCarouselElementItem","images_search":"#/components/schemas/Response0A3E90081762_SerpApiGoogleImagesImagesSearchElementItem","related_searches":"#/components/schemas/Response0A3E90081762_SerpApiGoogleImagesRelatedSearchesElementItem"},"propertyName":"type"},"properties":{"rank_absolute":{"description":" absolute rank in SERP for the target domain
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiGoogleMapsElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"maps_paid_item":"#/components/schemas/Response0A3E90081762_SerpApiMapsPaidItemElementItem","maps_search":"#/components/schemas/Response0A3E90081762_SerpApiMapsSearchElementItem"},"propertyName":"type"},"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"rating_distribution":{"additionalProperties":{"format":"Int64","type":["integer","null"]},"description":"the distribution of ratings of the business entity
the object displays the number of 1-star to 5-star ratings, as reviewed by users","type":["object","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiGoogleNewsElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"news_search":"#/components/schemas/Response0A3E90081762_SerpApiGoogleNewsNewsSearchElementItem","top_stories":"#/components/schemas/Response0A3E90081762_SerpApiGoogleNewsTopStoriesElementItem"},"propertyName":"type"},"properties":{"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiGoogleSearchByImagesElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"images":"#/components/schemas/Response0A3E90081762_SerpApiGoogleSearchByImagesImagesElementItem","organic":"#/components/schemas/Response0A3E90081762_SerpApiGoogleSearchByImagesOrganicElementItem"},"propertyName":"type"},"properties":{"page":{"type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:
left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"knowledge_graph_ai_overview_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphAiOverviewItemElementItem","knowledge_graph_carousel_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphCarouselItemElementItem","knowledge_graph_description_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphDescriptionItemElementItem","knowledge_graph_expanded_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphExpandedItemElementItem","knowledge_graph_hotels_booking_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphHotelsBookingItemElementItem","knowledge_graph_images_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphImagesItemElementItem","knowledge_graph_list_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphListItemElementItem","knowledge_graph_part_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphPartItemElementItem","knowledge_graph_row_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphRowItemElementItem","knowledge_graph_shopping_item":"#/components/schemas/Response0A3E90081762_SerpApiKnowledgeGraphShoppingItemElementItem"},"propertyName":"type"},"properties":{"page":{"description":"search results page number
indicates the number of the SERP page on which the element is located","type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP
equals null if calculate_rectangles in the POST request is not set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiPeopleAlsoAskExpandedElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"people_also_ask_ai_overview_expanded_element":"#/components/schemas/Response0A3E90081762_SerpApiPeopleAlsoAskAiOverviewExpandedElementItem","people_also_ask_expanded_element":"#/components/schemas/Response0A3E90081762_SerpApiPeopleAlsoAskExpandedElementItem"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiProductConsiderationExpandedElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"product_considerations_ai_overview_expanded_element":"#/components/schemas/Response0A3E90081762_SerpApiProductConsiderationsAiOverviewExpandedElementItem","product_considerations_expanded_element":"#/components/schemas/Response0A3E90081762_SerpApiProductConsiderationsExpandedElementItem"},"propertyName":"type"},"properties":{"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem":{"additionalProperties":false,"discriminator":{"mapping":{"youtube_channel":"#/components/schemas/Response0A3E90081762_SerpApiYoutubeChannelElementItem","youtube_playlist":"#/components/schemas/Response0A3E90081762_SerpApiYoutubePlaylistElementItem","youtube_video":"#/components/schemas/Response0A3E90081762_SerpApiYoutubeVideoElementItem","youtube_video_paid":"#/components/schemas/Response0A3E90081762_SerpApiYoutubeVideoPaidElementItem"},"propertyName":"type"},"properties":{"block_name":{"description":"name of the block in SERP
example:
\"People also watched\"
","type":["string","null"]},"block_rank":{"description":"block rank in SERP
position among all the blocks in SERP","type":["integer","null"]},"channel_id":{"description":"ID of the channel","type":["string","null"]},"rank_absolute":{"description":" absolute rank in SERP for the target domain
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of the channel","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BingAiOverviewSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"references":{"description":"additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingAnswerBoxSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"links":{"description":"links featured in the organic result","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"text
if there is none, equals null","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingCarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpApiCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingEventsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_EventsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingFeaturedSnippetSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"breadcrumb":{"description":"breadcrumb of the ad element in SERP","type":["string","null"]},"description":{"description":"description of the ad element in SERP","type":["string","null"]},"domain":{"description":"domain of the ad element in SERP","type":["string","null"]},"featured_title":{"description":"the title of the featured snippets source page","type":["string","null"]},"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"table":{"description":"results table
if there are none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the ad element in SERP","type":["string","null"]},"url":{"description":"relevant URL of the ad element in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingHotelsPackSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"date_from":{"description":"starting date of stay
in the format “year-month-date”
example:
2019-11-15","type":["string","null"]},"date_to":{"description":"ending date of stay
in the format “year-month-date”
example:
2019-11-17","type":["string","null"]},"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelsPackElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingImagesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"related_image_searches":{"deprecated":true,"description":"contains keywords and images related to the specified search term
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedImageSearchesElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingJobsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_JobsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingLocalPackSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"booking_url":{"type":["string","null"]},"cid":{"description":"bing-defined client id
unique id of a local establishment","type":["string","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"domain where the video is hosted","type":["string","null"]},"is_claimed":{"description":"business listing is claimed
if true, the business listing is claimed by the owner or representative","type":["boolean","null"]},"is_paid":{"description":"indicates whether the element is an ad","type":["boolean","null"]},"phone":{"description":"phone number","type":["string","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of the item","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingMapSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"title":{"description":"title of the item","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingOrganicSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"about_this_result":{"deprecated":true,"description":"contains information from the 'About this result' panel
note: about_this_result feature is not available in Bing search engine, that’s why it always equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AboutThisResultElement"}],"type":["object","null"]},"amp_version":{"description":"Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version","type":["boolean","null"]},"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"cache_url":{"description":"cached version of the page","type":["string","null"]},"checks":{"items":{"description":"indicates whether the element contains a video","type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"extended_people_also_search":{"description":"extension of the organic element
extension of the organic result containing related search queries
Note: extension appears in SERP upon clicking on the result and then bouncing back to search results","items":{"type":["string","null"]},"type":["array","null"]},"extended_snippet":{"description":"includes additional information appended after the result description in SERP","type":["string","null"]},"faq":{"deprecated":true,"description":"frequently asked questions
questions and answers extension shown below some search results
if there are none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FaqBox"}],"type":["object","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"images":{"description":"images of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"is_featured_snippet":{"description":"indicates whether the element is a featured_snippet","type":["boolean","null"]},"is_image":{"description":"indicates whether the element contains an image","type":["boolean","null"]},"is_malicious":{"description":"indicates whether the element is marked as malicious","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video","type":["boolean","null"]},"is_web_story":{"description":"indicates whether the element is marked as a web story","type":["boolean","null"]},"links":{"description":"sitelinks
the links shown below some search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"pre_snippet":{"description":"includes additional information appended before the result description in SERP","type":["string","null"]},"price":{"description":"pricing details
contains the pricing details of the product or service featured in the result","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"related_result":{"description":"related result from the same domain
related result from the same domain appears as a part of the main result snippet;
note: related_result feature is not available in Bing search engine, that’s why it always equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedResult"}],"type":["object","null"]},"type":["array","null"]},"related_search_url":{"description":"URL to a similar search
URL to a new search for the same keyword(s) on related sites","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the results element in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]},"website_name":{"description":"name of the source website","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingPaidSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"breadcrumb":{"description":"breadcrumb of the ad element in SERP","type":["string","null"]},"checks":{"items":{"type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the ad element in SERP","type":["string","null"]},"description_rows":{"description":"extended description
if there is none, equals null","items":{"type":["string","null"]},"type":["array","null"]},"domain":{"description":"domain of the ad element in SERP","type":["string","null"]},"extra":{"additionalProperties":{"type":["string","null"]},"description":"additional information about the result","type":["object","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"is_image":{"description":"indicates whether the element contains an image","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video","type":["boolean","null"]},"links":{"description":"links featured in the organic result","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AdLinkElement"}],"type":["object","null"]},"type":["array","null"]},"price":{"description":"price of booking a place for the specified dates of stay","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of the ad element in SERP","type":["string","null"]},"url":{"description":"relevant URL of the ad element in SERP","type":["string","null"]},"website_name":{"description":"website name in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingPeopleAlsoAskSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PeopleAlsoAskElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingPeopleAlsoSearchSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingQuestionsAndAnswersSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_QuestionsAndAnswersElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingRecipesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RecipesElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingRelatedSearchesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items in SERP","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingShoppingSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ShoppingElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingTopStoriesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopStoriesElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the item","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BingVideoSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_VideoElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BrandEntities":{"properties":{"category":{"description":"category of the brand","type":["string","null"]},"rank":{"description":"rank in the results","type":["integer","null"]},"title":{"description":"source title","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BulkMetricsBundleInfo":{"properties":{"featured_snippet":{"description":"traffic data from the featured snippet results in Google SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BulkMetricsInfo"}],"type":["object","null"]},"local_pack":{"description":"traffic data from the local pack results in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BulkMetricsInfo"}],"type":["object","null"]},"organic":{"description":"traffic data from organic search","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BulkMetricsInfo"}],"type":["object","null"]},"paid":{"description":"traffic data from paid search","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BulkMetricsInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_BulkMetricsInfo":{"properties":{"count":{"description":"total count of organic SERPs that contain the domain","format":"int64","type":["integer","null"]},"etv":{"description":"estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain ranks for
learn more about how the metric is calculated in this help center article","type":["number","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataAttributesInfo":{"properties":{"available_attributes":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"description":"available attributes
indicates attributes a business entity can offer","type":["object","null"]},"unavailable_attributes":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"description":"unavailable attributes
indicates attributes a business entity cannot offer","type":["object","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataBusinessListingsSearchLiveItem":{"properties":{"additional_categories":{"description":"additional business categories
additional Google My Business categories that describe the services provided by the business entity in more detail","items":{"type":["string","null"]},"type":["array","null"]},"address":{"description":"address of the business entity","type":["string","null"]},"address_info":{"description":"object containing address components of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AddressInfo"}],"type":["object","null"]},"attributes":{"description":"service details in a form of user-reviewed checks;
service details of a business entity displayed in a form of checks and based on user feedback and business category","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataAttributesInfo"}],"type":["object","null"]},"category":{"description":"business category
Google My Business general category that best describes the services provided by the business entity","type":["string","null"]},"category_ids":{"description":"global category IDs
universal category IDs that do not change based on the selected country","items":{"type":["string","null"]},"type":["array","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment
learn more about the identifier in this help center article","type":["string","null"]},"contact_info":{"description":"available contacts of the business
list of contacts to interact with the business","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataContactInfo"}],"type":["object","null"]},"type":["array","null"]},"description":{"description":"description of the element in SERP
the description of the business entity for which the results are collected","type":["string","null"]},"domain":{"description":"domain of the business entity","type":["string","null"]},"feature_id":{"description":"the unique identifier of the element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"first_seen":{"description":"date and time when our crawler found the business listing element for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2023-03-11 10:04:11 +00:00","type":["string","null"]},"hotel_rating":{"description":"hotel class rating
class ratings range between 1-5 stars, learn more
if there is no hotel class rating information, the value will be null","type":["integer","null"]},"is_claimed":{"description":"shows whether the entity is verified by its owner on Google Maps","type":["boolean","null"]},"last_updated_time":{"description":"date and time when the data was last updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2023-01-26 09:03:15 +00:00","type":["string","null"]},"latitude":{"description":"latitude coordinate of the local establishments in google maps
example:\"latitude\": 51.584091","type":["number","null"]},"local_business_links":{"description":"available interactions with the business
list of options to interact with the business directly from search results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseLocalBusinessLink"}],"type":["object","null"]},"type":["array","null"]},"logo":{"description":"URL of the logo featured in Google My Business profile","type":["string","null"]},"longitude":{"description":"longitude coordinate of the local establishment in google maps
example:\"longitude\": -0.31365919999999997","type":["number","null"]},"main_image":{"description":"URL of the main image featured in Google My Business profile","type":["string","null"]},"original_title":{"description":"original title of the element
original title not translated by Google","type":["string","null"]},"people_also_search":{"description":"related business entities","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PeopleAlsoSearch"}],"type":["object","null"]},"type":["array","null"]},"phone":{"description":"phone number of the business entity","type":["string","null"]},"place_id":{"description":"unique place identifier
place id of the local establishment featured in the element
learn more about the identifier in this help center article","type":["string","null"]},"place_topics":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"keywords mentioned in customer reviews
contains most popular keywords related to products/services mentioned in customer reviews of a business entity and the number of reviews mentioning each keyword
example:
\"place_topics\": {
\"egg roll\": 48,
\"birthday\": 33
}
information related to busy hours of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PopularTimes"}],"type":["object","null"]},"price_level":{"description":"property price level
can take values: inexpensive, moderate, expensive, very_expensive
if there is no price level information, the value will be null","type":["string","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"properties":{"rating_max":{"description":"the maximum value for a rating_type","format":"double","type":["number","null"]},"rating_type":{"description":"the type of rating\nhere you can find the following elements: Max5, Percents, CustomMax","type":["string","null"]},"value":{"description":"the value of the rating","format":"double","type":["number","null"]},"votes_count":{"description":"the amount of feedback","format":"int64","type":["integer","null"]}},"type":["object","null"]},"rating_distribution":{"additionalProperties":{"format":"Int64","type":["integer","null"]},"description":"the distribution of ratings of the business entity
the object displays the number of 1-star to 5-star ratings, as reviewed by users","type":["object","null"]},"services":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataServiceInfo"}],"type":["object","null"]},"type":["array","null"]},"snippet":{"description":"additional information on the business entity","type":["string","null"]},"title":{"description":"title of the element in SERP
the name of the business entity for which the results are collected","type":["string","null"]},"total_photos":{"description":"total count of images featured in Google My Business profile","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"absolute url of the business entity","type":["string","null"]},"work_time":{"description":"work time details
information related to operational hours of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessWorkHoursInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataBusinessListingsSearchLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataBusinessListingsSearchLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataBusinessListingsSearchLiveResultInfo":{"properties":{"count":{"description":"item types
the number of items in the items array","format":"int64","type":["integer","null"]},"items":{"description":"encountered item types
types of search engine results encountered in the items array;
possible item types: business_listing","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataBusinessListingsSearchLiveItem"}],"type":["object","null"]},"type":["array","null"]},"offset":{"format":"int64","type":["integer","null"]},"offset_token":{"type":["string","null"]},"total_count":{"description":"total number of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataBusinessListingsSearchLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataBusinessListingsSearchLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataContactInfo":{"properties":{"source":{"description":"data source","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"value":{"description":"the value of the rating","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment
learn more about the identifier in this help center article","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"feature_id":{"description":"the unique identifier of the 'reviews' element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"items":{"description":"found reviews
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleExtendedReviewsSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"place_id":{"description":"unique identifier of a business location assigned by Google
learn more about the identifier in this help center article","type":["string","null"]},"rating":{"description":"rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"sub_title":{"description":"subtitle of the 'reviews' element in SERP
additional information (e.g., address) on the 'reviews' element for which the reviews are collected","type":["string","null"]},"title":{"description":"title of the 'reviews' element in SERP
the name of the local establishment for which the reviews are collected","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleExtendedReviewsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"type of search engine","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleExtendedReviewsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleExtendedReviewsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoLiveAdvancedResultInfo":{"properties":{"about":{"description":"information about the hotel","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelAboutInfo"}],"type":["object","null"]},"address":{"description":"hotel address
physical address of the hotel","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"hotel_identifier":{"description":"identifier received in a POST array
this field will contain the hotel_identifier parameter specified when setting a task;
example:CgoI-KWyzenM_MV3EAE","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location":{"description":"information about the hotel location
information about the location where the hotel is located","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelLocationInfo"}],"type":["object","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"overview_images":{"description":"images displayed in the hotel overview
array containing URLs to images displayed in the hotel overview","items":{"type":["string","null"]},"type":["array","null"]},"phone":{"description":"hotel phone number
contact phone number of the hotel","type":["string","null"]},"prices":{"description":"pricing details of the hotel entity
contains information about the hotel's prices","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelPriceInfo"}],"type":["object","null"]},"reviews":{"description":"hotel reviews by criteria
information about reviews of the hotel entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelReviewInfo"}],"type":["object","null"]},"stars":{"description":"hotel class rating
class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary","type":["integer","null"]},"stars_description":{"description":"hotel class rating
class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary","type":["string","null"]},"title":{"description":"hotel title
the title of the hotel entity for which the results are collected","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"unique hotel identifier specified as \"hotel_id:$\"","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetAdvancedResultInfo":{"properties":{"about":{"description":"information about the hotel","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelAboutInfo"}],"type":["object","null"]},"address":{"description":"hotel address
physical address of the hotel","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"hotel_identifier":{"description":"unique hotel identifier
this field will contain the hotel_identifier parameter;
example:CgoI-KWyzenM_MV3EAE","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location":{"description":"information about the hotel location
information about the location where the hotel is located","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelLocationInfo"}],"type":["object","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"overview_images":{"description":"images displayed in the hotel overview
array containing URLs to images displayed in the hotel overview","items":{"type":["string","null"]},"type":["array","null"]},"phone":{"description":"hotel phone number
contact phone number of the hotel","type":["string","null"]},"prices":{"description":"pricing details of the hotel entity
contains information about the hotel's prices","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelPriceInfo"}],"type":["object","null"]},"reviews":{"description":"hotel reviews by criteria
information about reviews of the hotel entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelReviewInfo"}],"type":["object","null"]},"stars":{"description":"hotel class rating
class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary","type":["integer","null"]},"stars_description":{"description":"hotel class rating
class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary","type":["string","null"]},"title":{"description":"hotel title
the title of the hotel entity for which the results are collected","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"search engine specified when setting the task","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelInfoTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelInfoTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesItem":{"properties":{"hotel_identifier":{"description":"unique identifier of a hotel entity in Google search
example:CgoI-KWyzenM_MV3EAE","type":["string","null"]},"is_paid":{"description":"indicates a paid hotel listing
if true, related hotel_search_item is a paid ad
if false, related hotel_search_item is an organic hotel listing","type":["boolean","null"]},"location":{"description":"GPS coordinates of the hotel's location","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GpsCoordinatesLocationInfo"}],"type":["object","null"]},"overview_images":{"description":"featured images for a hotel","items":{"type":["string","null"]},"type":["array","null"]},"prices":{"description":"hotel price","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelPriceInfo"}],"type":["object","null"]},"reviews":{"description":"hotel reviews and rating information","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelReviewInfo"}],"type":["object","null"]},"stars":{"description":"hotel class rating
class rating that ranges between 1-5 stars","type":["integer","null"]},"title":{"description":"title of the hotel","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesLiveResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"encountered item types
types of search engine results encountered in the items array;
possible item types: hotel_search_item","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"item types
the number of items in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"array of items
note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"item types
the number of items in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character);
in order to obtain accurate search results, the location name is appended to the keyword automatically","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID \nformat","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleHotelSearchesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleHotelSearchesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoLiveResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"item types
types of search engine results encountered in the items array;
possible item types: google_business_info","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"encountered item types
types of search engine results encountered in the items array;
possible item types: google_business_info","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"item types
the number of items in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)
this field will contain the cid parameter if you specified it in the keyword field when setting a task;
example:cid:2946633002421908862
learn more about the parameter in this help center article","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain as specified in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"item types
types of search engine results encountered in the items array;
possible item types: google_business_info","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"array of directory items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"item types
the number of items in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)
this field will contain the cid parameter if you specified it in the keyword field when setting a task;
example:cid:2946633002421908862
learn more about the parameter in this help center article","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain as specified in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"search engine specified when setting the task","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessInfoTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskGetResultInfo":{"properties":{"business_updates_id":{"description":"identifier of the business updates element in SERP","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment
learn more about the cid identifier in this help center article","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"feature_id":{"description":"the unique identifier of the element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"item_types":{"description":"item types
types of search engine results encountered in the items array;
possible item types: google_business_post","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"encountered item types
types of search engine results encountered in the items array;
possible item types: google_business_post","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessPost"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"item types
the number of items in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)
this field will contain the cid parameter if you specified it in the keyword field when setting a task;
example:cid:2946633002421908862
learn more about the parameter in this help center article","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain as specified in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleMyBusinessUpdatesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersLiveResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment;
learn more about the identifier in this help center article","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"feature_id":{"description":" unique identifier of the SERP feature","type":["string","null"]},"item_types":{"description":"item types
types of search engine results encountered in the items array;
possible item types: google_business_question_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"array of items
items within google_business_question_item","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessQuestionItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the items array","format":"int64","type":["integer","null"]},"items_without_answers":{"description":"array of google business question items without answers","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessQuestionItem"}],"type":["object","null"]},"type":["array","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)
this field will contain the cid parameter if you specified it in the keyword field when setting a task;
example:cid:2946633002421908862
learn more about the parameter in this help center article","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain as specified in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment;
learn more about the identifier in this help center article","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"feature_id":{"description":" unique identifier of the SERP feature","type":["string","null"]},"item_types":{"description":"item types
types of search engine results encountered in the items array;
possible item types: google_business_question_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":" array of items within google_business_question_item
contains answers to the google business questions;
the maximum number of answers returned for each question: 5
possible item types google_business_answer_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessQuestionItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the items array","format":"int64","type":["integer","null"]},"items_without_answers":{"description":"array of google business question items without answers","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessQuestionItem"}],"type":["object","null"]},"type":["array","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)
this field will contain the cid parameter if you specified it in the keyword field when setting a task;
example:cid:2946633002421908862
learn more about the parameter in this help center article","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain as specified in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleQuestionsAndAnswersTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleReviewsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment
learn more about the identifier in this help center article","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"feature_id":{"description":"the unique identifier of the 'reviews' element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"items":{"description":"found reviews
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleReviewsSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"place_id":{"description":"unique identifier of a business location assigned by Google
learn more about the identifier in this help center article","type":["string","null"]},"rating":{"description":"rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"sub_title":{"description":"subtitle of the 'reviews' element in SERP
additional information (e.g., address) on the 'reviews' element for which the reviews are collected","type":["string","null"]},"title":{"description":"title of the 'reviews' element in SERP
the name of the local establishment for which the reviews are collected","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleReviewsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleReviewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleReviewsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: google","type":["string","null"]},"se_type":{"description":"type of search engine","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataGoogleReviewsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataGoogleReviewsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataServiceInfo":{"properties":{"category":{"description":"business category
Google My Business general category that best describes the services provided by the business entity","type":["string","null"]},"price":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"snippet":{"description":"additional information on the business entity","type":["string","null"]},"title":{"description":"title of the element in SERP
the name of the business entity for which the results are collected","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorReviewsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found reviews
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TripadvisorReviewSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location":{"description":"location of the local establishment
address of the local establishment for which the reviews are collected","type":["string","null"]},"rating":{"description":"rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"rating_distribution":{"additionalProperties":{"format":"Int64","type":["integer","null"]},"description":"rating distribution by votes
the distribution of votes across the rating in the range from 1 to 5","type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"title":{"description":"title of the 'reviews' element in SERP
the name of the local establishment for which the reviews are collected","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url_path":{"description":"URL path received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorReviewsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorReviewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorReviewsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: tripadvisor","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorReviewsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorReviewsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorSearchTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to Tripadvisor results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"item types encountered in the result
possible item types: tripadvisor_search_organic","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"Tripadvisor search listing results
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TripadvisorSearchOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
this field will contain the alias parameter if it was specified in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"the total number of results","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorSearchTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorSearchTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorSearchTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: tripadvisor","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTripadvisorSearchTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTripadvisorSearchTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotReviewsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"domain":{"description":"domain of the business entity","type":["string","null"]},"items":{"description":"found reviews
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TrustpilotReviewSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"location":{"description":"location of the business entity as specified on Trustpilot
address of the business entity for which the reviews are collected","type":["string","null"]},"rating":{"description":"rating of the corresponding business entity
popularity rate based on reviews and displayed in SERP","type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"title":{"description":"title of the 'reviews' element on Trustpilot
the name of the business entity for which the reviews are collected","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotReviewsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotReviewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotReviewsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: trustpilot","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotReviewsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotReviewsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotSearchTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"found reviews
you can get more results by using the depth parameter when setting a task","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TrustpilotSearchOrganic"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of items in the results array
you can get more results by using the depth parameter when setting a task","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotSearchTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotSearchTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotSearchTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task
can take the following values: trustpilot","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDataTrustpilotSearchTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataTrustpilotSearchTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_BusinessDataUserProfileInfo":{"properties":{"image_url":{"type":["string","null"]},"location":{"type":["string","null"]},"name":{"type":["string","null"]},"reviews_count":{"description":"total number of reviews submitted by the reviewer","format":"int64","type":["integer","null"]},"url":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessDirectoryInfo":{"properties":{"items":{"description":"encountered item types
types of search engine results encountered in the items array;
possible item types: google_business_info","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MapsSearch"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the element
domain of the online menu system","type":["string","null"]}},"type":"object"},"Response0A3E90081762_BusinessWorkHoursInfo":{"properties":{"work_hours":{"description":"open hours
information about work hours of the local establishment","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_WorkHours"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_CacheControl":{"properties":{"cachable":{"description":"indicates whether the page is cacheable","type":["boolean","null"]},"ttl":{"description":"time to livethe amount of time the browser caches a resource","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_CarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpApiCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_Categories":{"properties":{"category":{"description":"product category name","type":["string","null"]},"url":{"description":"product category URL
indicates the browse path on Amazon with the unique browse node ID (product category ID on Amazon)","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ChannelSubscribersCount":{"properties":{"count":{"description":"subscriber count","format":"int64","type":["integer","null"]},"displayed_count":{"description":"displayed subscriber count
subscriber count as displayed on YouTube","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ChatGptAdAdvertiser":{"properties":{"favicon_url":{"description":"URL of the advertiser's favicon image","type":["string","null"]},"name":{"description":"name of the advertiser","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ChatGptAdElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"advertiser":{"description":"information about the advertiser associated with the ad","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptAdAdvertiser"}],"type":["object","null"]},"domain":{"description":"domain","type":["string","null"]},"image_url":{"description":"URL of the image displayed in the ad","type":["string","null"]},"is_rendered":{"description":" indicates whether the ad is displayed to the user
if `true`, the ad is present in the response and shown on the page
if `false`, the ad is present in the response but not displayed to the user","type":["boolean","null"]},"snippet":{"description":"source description","type":["string","null"]},"title":{"description":"name of the brand","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatGptBrandEntity":{"properties":{"category":{"description":"category of the brand","type":["string","null"]},"markdown":{"description":"brand name in markdown format
contains brand name formatted in the markdown markup language","type":["string","null"]},"title":{"description":"name of the brand","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"urls":{"description":" array of URLs and domains relevant to the brand","type":["object","null"]}},"type":"object"},"Response0A3E90081762_ChatGptGoogleShoppingProduct":{"properties":{"catalog_id":{"description":"Google Shopping catalog identifier of the product
can be used as a product_id in Google Shopping API endpoints","type":["string","null"]},"ei":{"description":"event identifier
internal event identifier used by Google","type":["string","null"]},"gl":{"description":"country code
indicates the location for which search results are displayed","type":["string","null"]},"gpcid":{"description":"Google product cluster identifier
can be used as a gid in Google Shopping API endpoints","type":["string","null"]},"headline_offer_docid":{"description":"document identifier of the main offer in the headline
can be used as a data_docid in Google Shopping API endpoints","type":["string","null"]},"hl":{"description":"host language code
indicates the language in which search results are displayed","type":["string","null"]},"image_docid":{"description":"identifier for the displayed product’s image","type":["string","null"]},"mid":{"description":"merchant identifier
identifier of the seller or merchant account in Google Shopping","type":["string","null"]},"product_id":{"description":"product identifier
can be used as a data_docid in Google Shopping API endpoints","type":["string","null"]},"pvt":{"description":"product view type
internal Google parameter that specifies the product view type used when rendering the product item","type":["string","null"]},"query":{"description":"search query
search query used by ChatGPT to retrieve the product from Google Shopping","type":["string","null"]},"rds":{"description":"resource descriptor string
internal Google resource descriptor string that identifies the product within Google's Shopping index","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"uule":{"description":"encoded location parameter
indicates the location for a search","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ChatGptImagesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of ChatGPT results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GeminiImagesElement"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatGptLocalBusinessesElement":{"properties":{"address":{"description":"address of the local business","type":["string","null"]},"description":{"description":"description of the local business","type":["string","null"]},"domain":{"description":"domain","type":["string","null"]},"phone":{"description":"phone of the local business","type":["string","null"]},"rating":{"description":"rating of the corresponding local business
popularity rate based on reviews as displayed in the results","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"total number of reviews submitted for the local business","format":"int64","type":["integer","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ChatGptLocalBusinessesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of ChatGPT results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptLocalBusinessesElement"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatGptNavigationListElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"sources":{"description":"array of sources","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"name of the brand","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatGptProductsElement":{"properties":{"currency":{"description":"currency of the listed price
ISO code of the currency applied to the price","type":["string","null"]},"domain":{"description":"domain","type":["string","null"]},"id_to_token_map":{"description":"product identifier token
Base64-encoded token containing Google Shopping product IDs associated with the product","type":["string","null"]},"images":{"description":"image URLs of the element
contains URLs leading to the images on the original resource or DataForSEO storage (in case the original source is not available)","items":{"type":["string","null"]},"type":["array","null"]},"merchants":{"description":"merchant(s) offering the product","type":["string","null"]},"price":{"description":"product price","type":["number","null"]},"product_id":{"description":"product id","type":["string","null"]},"product_ids":{"description":"Google Shopping product identifiers
array of Google Shopping product IDs associated with the product","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptGoogleShoppingProduct"}],"type":["object","null"]},"type":["array","null"]},"rating":{"description":"rating of the corresponding local business
popularity rate based on reviews as displayed in the results","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"tag":{"description":"tag text","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ChatGptProductsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of ChatGPT results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptProductsElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatGptTableElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"brand_entities":{"description":"array of brand entities
contains information on brands mentioned in the text","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptBrandEntity"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"text":{"description":"text of the element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatGptTextElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseChatGptLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"brand_entities":{"description":"array of brand entities
contains information on brands mentioned in the text","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChatGptBrandEntity"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"sources":{"description":"array of sources","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ChatgptSearchResult":{"properties":{"breadcrumb":{"description":"breadcrumb","type":["string","null"]},"description":{"description":"result description","type":["string","null"]},"domain":{"description":"result domain","type":["string","null"]},"title":{"description":"result title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"result URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ClickstreamKeywordInfo":{"properties":{"age_distribution":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of clickstream-based metrics by age
learn more about how the metric is calculated in this help center article","type":["object","null"]},"gender_distribution":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of estimated clickstream-based metrics by gender
learn more about how the metric is calculated in this help center article","type":["object","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_volume":{"description":"average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea on google.com","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_CommercialUnitsElement":{"properties":{"domain":{"description":"domain where a link points","type":["string","null"]},"price":{"description":"price indicated in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_CommercialUnitsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CommercialUnitsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_CompareSitesElement":{"properties":{"domain":{"description":"domain where a link points","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_CompareSitesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CompareSitesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_Contacts":{"properties":{"emails":{"description":"array of emails
","items":{"type":["string","null"]},"type":["array","null"]},"telephones":{"description":"array of telephone numbers
","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisAvailableFiltersResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisAvailableFiltersTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisAvailableFiltersResultInfo":{"properties":{"search":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisAvailableFiltersTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisAvailableFiltersResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisCategoriesInfo":{"properties":{"category":{"items":{"type":["integer","null"]},"type":["array","null"]},"count":{"format":"int64","type":["integer","null"]}}},"Response0A3E90081762_ContentAnalysisCategoriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisCategoriesResultInfo":{"properties":{"category_code":{"description":"category code","type":["integer","null"]},"category_code_parent":{"description":"the code of the superordinate category
example:\"category_code\": 10178,
\"category_name\": \"Apparel Accessories\",
\"category_code_parent\": 10021
where category_code_parent
corresponds to: \"category_code\": 10178,","type":["integer","null"]},"category_name":{"description":"full name of the category","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisCategoriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisCategoryTrendsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoryTrendsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisCategoryTrendsLiveResultInfo":{"properties":{"connotation_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"connotation types
\"category_name\": \"Apparel Accessories\"
contains types of sentiments (sentiment polarity) related to the category citation and citation count per each sentiment type
possible connotation types: \"positive\", \"negative\", \"neutral\"","type":["object","null"]},"countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"countries
contains countries and citation count in each country
to obtain a full list of available countries, refer to the Locations endpoint","type":["object","null"]},"date":{"description":"date for which the data is provided","type":["string","null"]},"languages":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"languages
contains languages and citation count in each language
to obtain a full list of available languages, refer to the Languages endpoint","type":["object","null"]},"page_categories":{"description":"page categories
contains objects with page categories and citation count in each page category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesInfo"}],"type":["object","null"]},"type":["array","null"]},"page_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"page types
contains page types and citation count per each page type","type":["object","null"]},"rank":{"description":"rank of all URLs citing the keyword
normalized sum of ranks of all URLs citing the target keyword for the given date","type":["integer","null"]},"sentiment_connotations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"sentiment connotations
contains sentiments (emotional reactions) related to the target category citation and the number of citations per each sentiment
possible connotations: \"anger\", \"fear\", \"happiness\", \"love\", \"sadness\", \"share\", \"neutral\", \"fun\"","type":["object","null"]},"text_categories":{"description":"text categories
contains objects with text categories and citation count in each text category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesInfo"}],"type":["object","null"]},"type":["array","null"]},"top_domains":{"description":"top domains citing the target keyword
contains objects with top domains citing the target category and citation count per each domain","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopDomainInfo"}],"type":["object","null"]},"type":["array","null"]},"total_count":{"description":"total number of results in our database relevant to your request","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisCategoryTrendsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoryTrendsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisLanguagesResultInfo":{"properties":{"country_iso_code":{"type":["string","null"]},"location_code":{"type":["integer","null"]},"location_code_parent":{"type":["integer","null"]},"location_name":{"type":["string","null"]},"location_type":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_name":{"description":"full name of the location","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisPhraseTrendsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisPhraseTrendsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisPhraseTrendsLiveResultInfo":{"properties":{"connotation_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"connotation types
contains types of sentiments (sentiment polarity) related to the keyword citation and citation count per each sentiment type
possible connotation types: \"positive\", \"negative\", \"neutral\"","type":["object","null"]},"countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"countries
contains countries and citation count in each country
to obtain a full list of available countries, refer to the Locations endpoint","type":["object","null"]},"date":{"description":"date for which the data is provided","type":["string","null"]},"languages":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"languages
contains languages and citation count in each language
to obtain a full list of available languages, refer to the Languages endpoint","type":["object","null"]},"page_categories":{"description":"page categories
contains objects with page categories and citation count in each page category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesInfo"}],"type":["object","null"]},"type":["array","null"]},"page_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"page types
contains page types and citation count per each page type","type":["object","null"]},"rank":{"description":"rank of all URLs citing the keyword
normalized sum of ranks of all URLs citing the target keyword for the given date","type":["integer","null"]},"sentiment_connotations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"sentiment connotations
contains sentiments (emotional reactions) related to the target keyword citation and the number of citations per each sentiment
possible connotations: \"anger\", \"happiness\", \"love\", \"sadness\", \"share\", \"fun\"","type":["object","null"]},"text_categories":{"description":"text categories
contains objects with text categories and citation count in each text category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesInfo"}],"type":["object","null"]},"type":["array","null"]},"top_domains":{"description":"top domains citing the target keyword
contains objects with top domains citing the target keyword and citation count per each domain","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopDomainInfo"}],"type":["object","null"]},"type":["array","null"]},"total_count":{"description":"total number of results in our database relevant to your request","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisPhraseTrendsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisPhraseTrendsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisRatingDistributionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisRatingDistributionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisRatingDistributionLiveResultInfo":{"properties":{"max":{"description":"max rating on a distribution scaleurl","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AnalysisContentInfo"}],"type":["object","null"]},"country":{"description":"country code of the domain registration
to obtain a full list of available countries, refer to the Locations endpoint","type":["string","null"]},"domain":{"description":"domain name","type":["string","null"]},"domain_rank":{"description":"rank of the domain
this value is based on backlink data for the given domain from DataForSEO Backlink Index;domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"fetch_time":{"description":"date and time when our crawler visited the page
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"language":{"description":"main language of the domain
to obtain a full list of available languages, refer to the Languages endpoint","type":["string","null"]},"main_domain":{"description":"main domain","type":["string","null"]},"page_category":{"description":"contains all relevant page categories
product and service categories relevant for the page
to obtain a full list of available categories, refer to the Categories endpoint","items":{"type":"integer"},"type":["array","null"]},"page_types":{"description":"page types","items":{"type":"string"},"type":["array","null"]},"ratings":{"description":"ratings found on the page
all ratings found on the page based on microdata","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContententRatingInfo"}],"type":["object","null"]},"type":["array","null"]},"score":{"description":"citation prominence score
this value is based on url_rank, domain_rank, keyword presence in title, main_title, url, snippet
the higher the score, the more value the related citation has","type":["number","null"]},"social_metrics":{"description":"social media engagement metrics
data on social media interactions associated with the content based on website embeds developed and supported by social media platforms","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SocialMetricsInfo"}],"type":["object","null"]},"type":["array","null"]},"spam_score":{"description":"backlink spam score of the url
this value is based on backlink data for the given URL from DataForSEO Backlink Index;
learn more about how the metric is calculated on this help center page","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL where the citation was found","type":["string","null"]},"url_rank":{"description":"rank of the url
this value is based on backlink data for the given URL from DataForSEO Backlink Index;url_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisSearchLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSearchLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisSearchLiveResultInfo":{"properties":{"items":{"description":"contains citations and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSearchLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisSearchLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSearchLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisSentimentAnalysisLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSentimentAnalysisLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisSentimentAnalysisLiveResultInfo":{"properties":{"positive_connotation_distribution":{"description":"citation distribution by sentiment connotation types\ncontains objects with citation counts and relevant data distributed by types of sentiments (sentiment polarity);\npossible sentiment connotation types: positive, negative, neutral","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PositiveConnotationDistribution"}],"type":["object","null"]},"sentiment_connotation_distribution":{"description":"citation distribution by sentiment connotations\ncontains objects with citation counts and relevant data distributed by sentiments (emotional reactions);\npossible sentiment connotation types: anger, happiness, love, sadness, share, fun","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SentimentConnotationDistribution"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisSentimentAnalysisLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSentimentAnalysisLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisSummaryInfo":{"properties":{"connotation_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"connotation types
contains types of sentiments (sentiment polarity) related to the keyword citation and citation count per each sentiment type
possible sentiment connotation types: positive, negative, neutral","type":["object","null"]},"countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"countries
contains countries and citation count in each country
to obtain a full list of available countries, refer to the Locations endpoint","type":["object","null"]},"languages":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"languages
contains languages and citation count in each language
to obtain a full list of available languages, refer to the Languages endpoint","type":["object","null"]},"page_categories":{"description":"page categories
contains objects with page categories and citation count in each page category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesInfo"}],"type":["object","null"]},"type":["array","null"]},"page_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"page types
contains page types and citation count per each page type","type":["object","null"]},"rank":{"description":"rank of all URLs citing the keyword
normalized sum of ranks of all URLs citing the target keyword","type":["integer","null"]},"sentiment_connotations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"sentiment connotations
contains sentiments (emotional reactions) related to the target keyword citation and the number of citations per each sentiment
possible sentiment connotations: anger, happiness, love, sadness, share, fun","type":["object","null"]},"text_categories":{"description":"text categories
contains objects with text categories and citation count in each text category
to obtain a full list of available categories, refer to the Categories endpoint","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisCategoriesInfo"}],"type":["object","null"]},"type":["array","null"]},"top_domains":{"description":"top domains citing the target keyword
contains objects with top domains citing the target keword and citation count per each domain","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopDomainInfo"}],"type":["object","null"]},"type":["array","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentAnalysisSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentAnalysisSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ContentCommentInfo":{"properties":{"author":{"description":"author of the comment","type":["string","null"]},"have_form":{"description":"","type":["boolean","null"]},"primary_content":{"description":"primary content on the page\nyou can find more information about content priority calculation in this help center article","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SectionContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"publish_date":{"description":"date when the comment was published","type":["string","null"]},"rating":{"description":"product’s rating\ncontains information about the rating a customer has given to the product","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContententRatingInfo"}],"type":["object","null"]},"title":{"description":"title of the customer’s comment","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentOfferInfo":{"properties":{"name":{"description":"name of the product","type":["string","null"]},"price":{"description":"price of the product","format":"double","type":["number","null"]},"price_currency":{"description":"price currency","type":["string","null"]},"price_valid_until":{"description":"displays the date and time until which the price is valid\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nexample: \"2022-11-01 10:02:52 +00:00\"","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentParsingElement":{"properties":{"fetch_time":{"description":"date and time when the content was fethced
example:
\"2022-11-01 10:02:52 +00:00\"","type":["string","null"]},"page_as_markdown":{"description":"page content in the markdown format
page content in the text-to-HTML markdown format
specify markdown_view as true in the request to return the value","type":["string","null"]},"page_content":{"description":"parsed content of the page
","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageContentInfo"}],"type":["object","null"]},"status_code":{"description":"general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContentUrlInfo":{"properties":{"anchor_text":{"description":"text of the URL’s anchor","type":["string","null"]},"url":{"description":"contains other URLs and anchors found in the content element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ContententRatingInfo":{"properties":{"max_rating_value":{"description":"maximum value for the rating name","format":"double","type":["number","null"]},"name":{"description":"rating name\nhere you can find the following elements: Max5, Percents, CustomMax","type":["string","null"]},"rating_count":{"description":"number of votes","format":"int64","type":["integer","null"]},"rating_value":{"description":"the value of the rating","format":"double","type":["number","null"]},"relative_rating":{"description":"relative rating","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_CountryDistribution":{"properties":{"country_iso_code":{"description":"country ISO code","type":["string","null"]},"percentage":{"description":"percentage of global search volume","type":["number","null"]},"search_volume":{"description":"clickstream-based average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea based on clickstream
you can learn more about clickstream search volume in this Help Center article","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_CoursesElement":{"properties":{"date":{"description":"the date when the page source of the element was published","type":["string","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"image_url":{"description":"URL of the image","type":["string","null"]},"rating":{"description":"the element’s rating \nthe popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"source":{"description":"source of the element\nindicates the source of information included in the top_stories_element","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_CoursesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"categories":{"description":"array of course categories\ncontains a list of categories relevant to courses","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CoursesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of a given link element","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_CrawlStatusInfo":{"properties":{"max_crawl_pages":{"description":"maximum number of pages to crawl\n indicates the max_crawl_pages limit you specified when setting a task","format":"int64","type":["integer","null"]},"pages_crawled":{"description":"number of crawled pages","format":"int64","type":["integer","null"]},"pages_in_queue":{"description":"number of pages that are currently in the crawling queue","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_CurrencyBoxSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"converted_currency":{"description":"converted currency","type":["string","null"]},"converted_value":{"description":"value converted to a requested currency
indicates the exact value based on Google Fincance data at the time when our API pulled the results
note that exchange rates displayed in the currency_box element may be delayed according to the Google Finance disclaimer","type":["number","null"]},"currency":{"description":"currency of the listed price
ISO code of the currency applied to the price","type":["string","null"]},"graph":{"description":"contains data provided in the graph of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Graph"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"value":{"description":"the value of the rating","type":["number","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsAnswerBoxSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"text
if there is none, equals null","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsCarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsCommercialUnitsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CommercialUnitsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsCoursesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"categories":{"description":"array of course categories\ncontains a list of categories relevant to courses","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CoursesElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataLabsEventsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_EventsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsExploreBrandsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ExploreBrandsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataLabsFeaturedSnippetSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"backlinks_info":{"description":"backlinks information for the relevant page URL","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksInfo"}],"type":["object","null"]},"clickstream_etv":{"description":"estimated traffic volume based on clickstream data
calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain or webpage ranks for;
to retrieve results for this field, the parameter include_clickstream_data must be set to true;
learn more about how the metric is calculated in this help center article","format":"double","type":["number","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"subdomain in SERP","type":["string","null"]},"estimated_paid_traffic_cost":{"description":"estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for all keywords that a domain or webpage ranks for;
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search;
learn more about how the metric is calculated in this help center article","type":["number","null"]},"etv":{"description":"estimated traffic volume
estimated organic monthly traffic to the domain or webpage;
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain or webpage rank for;
learn more about how the metric is calculated in this help center article","type":["number","null"]},"featured_title":{"description":"the title of the featured snippets source page","type":["string","null"]},"main_domain":{"description":"primary domain name in SERP","type":["string","null"]},"rank_changes":{"description":"changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankChanges"}],"properties":{"is_down":{"description":"rank of this element went down\nif the value is true, position of the element in SERP is lower compared to the previous check","type":"boolean"},"is_new":{"description":"element was previously present in SERP\nif the value is true, previously collected SERP didn’t contain this element","type":"boolean"},"is_up":{"description":"rank of this element went up\nif the value is true, position of the element in SERP is higher compared to the previous check","type":"boolean"},"previous_rank_absolute":{"description":"previous absolute rank in SERP\nindicates previous rank of the element in Google SERP;\nif this element is new, the value will be null","type":["number","null"]}},"type":["object","null"]},"rank_info":{"description":"page and domain rank information","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankInfo"}],"type":["object","null"]},"relative_url":{"description":"URL in SERP that does not specify the HTTPs protocol and domain name","type":["string","null"]},"table":{"description":"results table
if there are none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsFindResultsOnSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FindResultsOnElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsFoundOnWebSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FoundOnWebElement"}],"type":["object","null"]},"type":["array","null"]},"related_searches":{"description":"search queries related to the elment","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataLabsGoogleFlightsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFlightsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsGoogleHotelsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"hotel_identifier":{"description":"unique hotel identifier
unique hotel identifier assigned by Google;
example: \"CgoIjaeSlI6CnNpVEAE\"","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsGooglePostsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"cid":{"description":"google-defined client id","type":["string","null"]},"feature":{"description":"the additional feature of the review","type":["string","null"]},"posts_id":{"description":"the identifier of the google_posts feature","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataLabsGoogleReviewsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"cid":{"description":"google-defined client id","type":["string","null"]},"feature":{"description":"the additional feature of the review","type":["string","null"]},"place_id":{"description":"the identifier of a place","type":["string","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the number of reviews","format":"int64","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsHotelsPackSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"date_from":{"description":"starting date of stay
in the format “year-month-date”
example:
2019-11-15","type":["string","null"]},"date_to":{"description":"ending date of stay
in the format “year-month-date”
example:
2019-11-17","type":["string","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelsPackElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsImagesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"related_image_searches":{"deprecated":true,"description":"contains keywords and images related to the specified search term
if there are none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedImageSearchesElement"}],"type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsJobsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_JobsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsKnowledgeGraphSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"card_id":{"description":"card id","type":["string","null"]},"cid":{"description":"google-defined client id","type":["string","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"image_url":{"description":"URL of the image from knowledge graph","type":["string","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},"type":["array","null"]},"logo_url":{"description":"URL of the logo from knowledge graph","type":["string","null"]},"sub_title":{"description":"subtitle of the item","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsLocalPackSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"backlinks_info":{"description":"backlinks information for the ranked website","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksInfo"}],"type":["object","null"]},"clickstream_etv":{"description":"estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article","format":"double","type":["number","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"subdomain in SERP","type":["string","null"]},"estimated_paid_traffic_cost":{"description":"estimated cost of paid monthly search traffic represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values learn more about how the metric is calculated in this help center article","type":["number","null"]},"etv":{"description":"estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword learn more about how the metric is calculated in this help center article","type":["number","null"]},"is_paid":{"description":"indicates whether the element is an ad","type":["boolean","null"]},"main_domain":{"description":"primary domain name in SERP","type":["string","null"]},"phone":{"description":"phone number","type":["string","null"]},"rank_changes":{"description":"changes in rankings contains information about the ranking changes of the SERP element since the previous_updated_time","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankChanges"}],"properties":{"is_down":{"description":"rank of this element went down\nif the value is true, position of the element in SERP is lower compared to the previous check","type":"boolean"},"is_new":{"description":"element was previously present in SERP\nif the value is true, previously collected SERP didn’t contain this element","type":"boolean"},"is_up":{"description":"rank of this element went up\nif the value is true, position of the element in SERP is higher compared to the previous check","type":"boolean"},"previous_rank_absolute":{"description":"previous absolute rank in SERP\nindicates previous rank of the element in Google SERP;\nif this element is new, the value will be null","type":["number","null"]}},"type":["object","null"]},"rank_info":{"description":"page and domain rank information","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"relative_url":{"description":"URL in SERP that does not specify the HTTPs protocol and domain name","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":"relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsLocalServicesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"items":{"description":"historical SERPs and related data found in the database","type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsMapSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsMathSolverSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MathSolverElement"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"result":{"description":"solution to the equation
solution to the mathematical equation specified in the keyword field when setting a task","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsMentionCarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MentionCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataLabsMultiCarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MultiCarouselElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsOrganicSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"about_this_result":{"deprecated":true,"description":"contains information from the 'About this result' panel
'About this result' panel provides additional context about why Google returned this result for the given query;
this feature appears after clicking on the three dots next to most results","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AboutThisResultElement"}],"type":["object","null"]},"amp_version":{"description":"Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
Note: this check no longer appears in SERP","type":["boolean","null"]},"backlinks_info":{"description":"backlinks information for the relevant page URL","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksInfo"}],"type":["object","null"]},"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"checks":{"description":"array of properties detected for the SERP element
lists the properties that are true for this element
each value in the array represents a detected property
example:
if is_image is present in the array, the element contains an image
possible values in the array:is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_cited
equals null if none of the properties are detected for the element
learn more about the checks array in this Help Center article","items":{"type":["string","null"]},"type":["array","null"]},"clickstream_etv":{"description":"estimated traffic volume based on clickstream data
calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain or webpage ranks for;
to retrieve results for this field, the parameter include_clickstream_data must be set to true;
learn more about how the metric is calculated in this help center article","format":"double","type":["number","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"subdomain in SERP","type":["string","null"]},"estimated_paid_traffic_cost":{"description":"estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for all keywords that a domain or webpage ranks for;
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search;
learn more about how the metric is calculated in this help center article","type":["number","null"]},"etv":{"description":"estimated traffic volume
estimated organic monthly traffic to the domain or webpage;
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain or webpage rank for;
learn more about how the metric is calculated in this help center article","type":["number","null"]},"extended_snippet":{"description":"includes additional information appended after the result description in SERP","type":["string","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"is_featured_snippet":{"description":"indicates whether the element is a featured_snippet
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_image":{"description":"indicates whether the element contains an image
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_malicious":{"description":"indicates whether the element is marked as malicious
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video
Note: this check no longer appears in SERP","type":["boolean","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"main_domain":{"description":"primary domain name in SERP","type":["string","null"]},"pre_snippet":{"description":"includes additional information appended before the result description in SERP","type":["string","null"]},"rank_changes":{"description":"changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankChanges"}],"properties":{"is_down":{"description":"rank of this element went down\nif the value is true, position of the element in SERP is lower compared to the previous check","type":"boolean"},"is_new":{"description":"element was previously present in SERP\nif the value is true, previously collected SERP didn’t contain this element","type":"boolean"},"is_up":{"description":"rank of this element went up\nif the value is true, position of the element in SERP is higher compared to the previous check","type":"boolean"},"previous_rank_absolute":{"description":"previous absolute rank in SERP\nindicates previous rank of the element in Google SERP;\nif this element is new, the value will be null","type":["number","null"]}},"type":["object","null"]},"rank_info":{"description":"page and domain rank information","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"relative_url":{"description":"URL in SERP that does not specify the HTTPs protocol and domain name","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]},"website_name":{"description":"relevant website name in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsPaidSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"backlinks_info":{"description":"backlinks information for the ranked website","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksInfo"}],"type":["object","null"]},"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"checks":{"description":"array of properties detected for the SERP elementlists the properties that are true for this elementeach value in the array represents a detected property example:if is_image is present in the array, the element contains an imagepossible values in the array:is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_citedequals null if none of the properties are detected for the elementlearn more about the checks array in this Help Center article","items":{"type":["string","null"]},"type":["array","null"]},"clickstream_etv":{"description":"estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article","format":"double","type":["number","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"description_rows":{"description":"extended description if there is none, equals null","items":{"type":["string","null"]},"type":["array","null"]},"domain":{"description":"subdomain in SERP","type":["string","null"]},"estimated_paid_traffic_cost":{"description":"estimated cost of paid monthly search traffic represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values learn more about how the metric is calculated in this help center article","type":["number","null"]},"etv":{"description":"estimated traffic volume estimated organic monthly traffic to the domain calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword learn more about how the metric is calculated in this help center article","type":["number","null"]},"extra":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"links":{"description":"sitelinks the links shown below some of Google's search results if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AdLinkElement"}],"type":["object","null"]},"type":["array","null"]},"main_domain":{"description":"primary domain name in SERP","type":["string","null"]},"rank_changes":{"description":"changes in rankings contains information about the ranking changes of the SERP element since the previous_updated_time","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankChanges"}],"properties":{"is_down":{"description":"rank of this element went down\nif the value is true, position of the element in SERP is lower compared to the previous check","type":"boolean"},"is_new":{"description":"element was previously present in SERP\nif the value is true, previously collected SERP didn’t contain this element","type":"boolean"},"is_up":{"description":"rank of this element went up\nif the value is true, position of the element in SERP is higher compared to the previous check","type":"boolean"},"previous_rank_absolute":{"description":"previous absolute rank in SERP\nindicates previous rank of the element in Google SERP;\nif this element is new, the value will be null","type":["number","null"]}},"type":["object","null"]},"rank_info":{"description":"page and domain rank information","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankInfo"}],"type":["object","null"]},"relative_url":{"description":"URL in SERP that does not specify the HTTPs protocol and domain name","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":"relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsPeopleAlsoAskSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PeopleAlsoAskElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsPeopleAlsoSearchSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsPodcastsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PodcastsElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataLabsPopularProductsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PopularProductsElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsQuestionsAndAnswersSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_QuestionsAndAnswersElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsRecipesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RecipesElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsRelatedSearchesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsScholarlyArticlesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ScholarlyArticlesElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsShoppingSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ShoppingElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsStocksBoxSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"graph":{"description":"contains data provided in the graph of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Graph"}],"type":["object","null"]},"price":{"description":"price of booking a place for the specified dates of stay","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"source":{"description":"source of additional information about the result","type":["string","null"]},"table":{"description":"table element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsTopSightsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopSightsElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsTopStoriesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopStoriesElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsTwitterSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TwitterElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsVideoSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_VideoElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataLabsVisualStoriesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveItem":{"properties":{"keyword":{"description":"keyword in a POST array","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"search_volume":{"description":"average monthly search volume rate
represents the (approximate) number of searches for the returned keyword on Amazon","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveResultInfo":{"properties":{"items":{"description":"contains keyword search volume data data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonBulkSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveItem":{"properties":{"asin":{"description":"ASIN in a POST array","type":["string","null"]},"avg_position":{"description":"average position of the product in Amazon SERP
Note: average position is calculated for intersected keywords only;
the value for a given product may differ when combined with different target products","format":"float","type":["number","null"]},"competitor_metrics":{"description":"metrics for intersecting keywords
ranking data relevant to the keywords that the provided asin shares with the target asin;
Note: in this object ranking data is provided for the returned competitor's asin","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonMetricsBundleInfo"}],"type":["object","null"]},"full_metrics":{"description":"metrics for all keywords of the product
full overview of ranking data relevant to all keywords that the provided asin is ranking for","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonMetricsBundleInfo"}],"type":["object","null"]},"intersections":{"description":"number of intersecting keywords","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"sum_position":{"description":"sum of all product positions in Amazon SERP
Note: average position is calculated for intersected keywords only;
the value for a given product may differ when combined with different target products","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveResultInfo":{"properties":{"asin":{"description":"ASIN in a POST array","type":["string","null"]},"items":{"description":"contains detected Amazon product competitors and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductCompetitorsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveItem":{"properties":{"intersection_result":{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonInfo"}],"type":["object","null"]},"description":"data on the intersection","type":["object","null"]},"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonKeywordData"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveResultInfo":{"properties":{"asins":{"additionalProperties":{"type":["string","null"]},"description":"ASINs in a POST array","type":["object","null"]},"items":{"description":"contains detected Amazon product competitors and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductKeywordIntersectionsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveItem":{"properties":{"asin":{"description":"ASIN of the product
unique product identifier on Amazon;
for more information, refer to this help center guide","type":["string","null"]},"metrics":{"description":"average keyword position of the product","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonMetricsBundleInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveResultInfo":{"properties":{"items":{"description":"contains detected Amazon product competitors and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonProductRankOverviewLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveItem":{"properties":{"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"ranked_serp_element":{"description":"contains data on the products's SERP element found for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonRankedSerpElement"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveResultInfo":{"properties":{"asin":{"description":"ASIN in a POST array","type":["string","null"]},"items":{"description":"contains detected Amazon product competitors and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonRankedKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveItem":{"properties":{"depth":{"description":"keyword search depth","type":["integer","null"]},"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonKeywordData"}],"type":["object","null"]},"related_keywords":{"description":"list of related keywords
represents the list of search queries which are related to the keyword returned in the array above","items":{"type":"string"},"type":["array","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveResultInfo":{"properties":{"items":{"description":"contains objects with keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"seed_keyword":{"description":"keyword in a POST array","type":["string","null"]},"seed_keyword_data":{"description":"keyword data for the seed keyword
fields in the object are identical to that of keyword_data","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonKeywordData"}],"type":["object","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAmazonRelatedKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleAppCompetitorsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleAppCompetitorsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleAppCompetitorsLiveResultInfo":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"items":{"description":"contains data related to the app_id and competitor applications","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsleAppCompetitorsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAppleAppCompetitorsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleAppCompetitorsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleAppIntersectionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleAppIntersectionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleAppIntersectionLiveResultInfo":{"properties":{"app_ids":{"additionalProperties":{"type":["string","null"]},"description":"ids of the apps in a POST array","type":["object","null"]},"items":{"description":"contains data related to the ranking keywords for the app specified in the app_id field","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsleAppIntersectionLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAppleAppIntersectionLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleAppIntersectionLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleBulkAppMetricsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleBulkAppMetricsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleBulkAppMetricsLiveResultInfo":{"properties":{"items":{"description":"contains data related to the ranking app metrics of the specified application","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsleBulkAppMetricsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAppleBulkAppMetricsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleBulkAppMetricsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveItem":{"properties":{"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"ranked_serp_element":{"description":"contains data on the domain's SERP element found for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppleRankedSerpElementInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveResultInfo":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"items":{"description":"contains data related to the ranking keywords for the app specified in the app_id field","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAppleKeywordsForAppLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAvailableFiltersResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAvailableFiltersTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsAvailableFiltersResultInfo":{"properties":{"app_competitors":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"app_intersection":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"categories_for_domain":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"competitors_domain":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"database_rows_count":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"domain_intersection":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"domain_metrics_by_categories":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"keyword_ideas":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"keyword_suggestions":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"keywords_for_app":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"keywords_for_categories":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"keywords_for_site":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"page_intersection":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"product_competitors":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"product_keyword_intersections":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"ranked_keywords":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"related_keywords":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"relevant_pages":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"serp_competitors":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"subdomains":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]},"top_searches":{"additionalProperties":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsAvailableFiltersTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
contains the full list of available parameters that can be used for data filtration
the parameters are grouped by the endpoint they can be used with","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsAvailableFiltersResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsCarouselElement":{"properties":{"sub_title":{"description":"subtitle of the item","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAppCompetitorsLiveResultInfo":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"items":{"description":"contains data related to the app_id and competitor applications","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsleAppCompetitorsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleAppCompetitorsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAppIntersectionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleAppIntersectionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAppIntersectionLiveResultInfo":{"properties":{"app_ids":{"additionalProperties":{"type":["string","null"]},"description":"ids of the apps in a POST array","type":["object","null"]},"items":{"description":"contains data related to the ranking keywords for the app specified in the app_id field","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsleAppIntersectionLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAppIntersectionLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleAppIntersectionLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAvailableHistoryResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleAvailableHistoryTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAvailableHistoryResultInfo":{"properties":{"date":{"description":"available dateindicates the date of the range available for setting in the Domain Metrics by Categories endpointexample:2022-05-16","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleAvailableHistoryTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of objects containing results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleAvailableHistoryResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkAppMetricsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo":{"properties":{"items":{"description":"contains data related to the ranking app metrics of the specified application","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsleBulkAppMetricsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveItem":{"properties":{"keyword":{"description":"keyword in a POST array","type":["string","null"]},"keyword_difficulty":{"description":"difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;
learn more about the metric in this help center guide","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related keyword difficulty scores","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkKeywordDifficultyLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveItem":{"properties":{"metrics":{"description":"traffic data relevant to the specified domain","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BulkMetricsBundleInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveResultInfo":{"properties":{"items":{"description":"array of items with relevant traffic estimation data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleBulkTrafficEstimationLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveItem":{"properties":{"categories":{"description":"product and service categories
you can download the full list of possible categories","items":{"type":"integer"},"type":["array","null"]},"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"ranking data relevant to the specified domain or subdomain","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveResultInfo":{"properties":{"items":{"description":"contains relevant categories and related ranking data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain or subdomain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForDomainLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveItem":{"properties":{"categories":{"description":"product and service categories
you can download the full list of possible categories","items":{"type":"integer"},"type":["array","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related keyword difficulty scores","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCategoriesForKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveItem":{"properties":{"avg_position":{"description":"average position of the domain in SERP
Note: average position is calculated for intersected keywords only;
the value for a given domain may differ when combined with different target websites","format":"float","type":["number","null"]},"competitor_metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"metrics for intersecting keywords
ranking and traffic data relevant to the keywords that the provided domain shares with the target domain
note: in this array ranking and traffic data is provided for the returned competitor's domain","type":["object","null"]},"domain":{"description":"domain name","type":["string","null"]},"full_domain_metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"metrics for all keywords of the domain
full overview of ranking and traffic data relevant to all keywords that the provided domain is ranking for","type":["object","null"]},"intersections":{"description":"number of intersecting keywords","type":["integer","null"]},"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"metrics for intersecting keywords
ranking and traffic data relevant to the keywords that the provided domain shares with the target domain
note: in this array ranking and traffic data is provided for the target considering the keywords target shares in search with the competitor's domain","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"sum_position":{"description":"sum of all domain positions in SERP
Note: average position is calculated for intersected keywords only;
the value for a given domain may differ when combined with different target websites","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveResultInfo":{"properties":{"items":{"description":"contains data related to the target and competitor domains","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleCompetitorsDomainLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveItem":{"properties":{"first_domain_serp_element":{"description":"contains data on the first domain's SERP element found for the returned keyword the list of supported SERP elements can be found below","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"second_domain_serp_element":{"description":"contains data on the second domain's SERP element found for the returned keyword the list of supported SERP elements can be found below","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveResultInfo":{"properties":{"items":{"description":"contains keywords, relevant SERP elements and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target1":{"description":"the first target domain in a POST array","type":["string","null"]},"target2":{"description":"the second target domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainIntersectionLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveItem":{"properties":{"domain":{"description":"domain found for the specified category","type":["string","null"]},"main_domain":{"description":"primary domain","type":["string","null"]},"metrics_difference":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"metrics difference between first_date and second_date
calculated by subtracting domain metrics as of the greater date from domain metrics as of the smaller date","type":["object","null"]},"metrics_history":{"additionalProperties":{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"}],"type":["object","null"]},"type":"object"},"description":"historical ranking and traffic data of the domain","type":["object","null"]},"organic_count":{"description":"current total count of organic SERPs that contain the domain","format":"int64","type":["integer","null"]},"organic_etv":{"description":"current organic ETV of the domain","type":["number","null"]},"organic_is_lost":{"description":"current number of lost ranked elements
indicates how many ranked elements of the domain were previously presented in SERPs, but weren’t found during the last check","type":["integer","null"]},"organic_is_new":{"description":"current number of new ranked elements
indicates how many new ranked elements were found for the domain","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"top_categories":{"description":"categories for which domains are collected","items":{"type":["integer","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveResultInfo":{"properties":{"categories":{"description":"categories in a POST array","items":{"type":"integer"},"type":["array","null"]},"items":{"description":"contains historical ranking and traffic data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainMetricsByCategoriesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveItem":{"properties":{"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"ranking data relevant to the specified domain","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo":{"properties":{"items":{"description":"contains ranking and traffic data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveItem":{"properties":{"metrics":{"description":"traffic data relevant to the specified domain","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HistoricalMetricsBundleInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResultInfo":{"properties":{"items":{"description":"array of items with relevant traffic estimation data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveItem":{"properties":{"history":{"description":"array of objects with historical data for the keyword","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_History"}],"type":["object","null"]},"type":["array","null"]},"keyword":{"description":"keyword
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalKeywordDataLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveItem":{"properties":{"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"ranking data relevant to the specified domain","type":["object","null"]},"month":{"description":"month for which the data is provided","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"year":{"description":"year for which the data is provided","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveResultInfo":{"properties":{"items":{"description":"contains historical ranking and traffic data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalRankOverviewLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveItem":{"properties":{"avg_backlinks_info":{"description":"backlink data for the returned keyword\nthis object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 websites ranking organically for the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvgBacklinksInfo"}],"type":["object","null"]},"clickstream_keyword_info":{"description":"clickstream data for the returned keyword\nto retrieve results for this field, the parameter include_clickstream_data must be set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ClickstreamKeywordInfo"}],"type":["object","null"]},"keyword":{"description":"keyword\nkeyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)","type":["string","null"]},"keyword_info":{"description":"keyword data for the returned keyword idea","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfo"}],"type":["object","null"]},"keyword_info_normalized_with_bing":{"description":"contains keyword search volume normalized with Bing search volume","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfoNormalizedWithInfo"}],"type":["object","null"]},"keyword_info_normalized_with_clickstream":{"description":"contains keyword search volume normalized with clickstream data","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfoNormalizedWithInfo"}],"type":["object","null"]},"keyword_properties":{"description":"additional information about the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordProperties"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"search_partners":{"description":"indicates data for Google and partner sites\nif true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search;\nif false, the results are returned for Google search sites only","type":["boolean","null"]},"serp_info":{"description":"SERP data\nthe value will be null if you didn’t set the field include_serp_info to true in the POST array or if there is no SERP data for this keyword in our database","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveItem":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
answer_box, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"se_type":{"description":"search engine type in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveResultInfo":{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type in a POST array","type":["string","null"]},"total_count":{"description":"the total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
the array includes objects with SERPs for each month within the specified time frame","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleHistoricalSerpsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordIdeasLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordIdeasLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordIdeasLiveResultInfo":{"properties":{"items":{"description":"contains keyword ideas and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"offset":{"description":"current offset value","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"seed_keywords":{"description":"keywords in a POST array
keywords are returned with decoded %## (plus character '+' will be decoded to a space character)","items":{"type":["string","null"]},"type":["array","null"]},"total_count":{"description":"total number of results relevant to your request in our database ","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordIdeasLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordIdeasLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveItem":{"properties":{"avg_backlinks_info":{"description":"backlink data for the returned keyword
this object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 websites ranking organically for the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvgBacklinksInfo"}],"type":["object","null"]},"clickstream_keyword_info":{"description":"clickstream data for the returned keyword
to retrieve results for this field, the parameter include_clickstream_data must be set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ClickstreamKeywordInfo"}],"type":["object","null"]},"keyword":{"description":"keyword
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"keyword_info":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfo"}],"type":["object","null"]},"keyword_info_normalized_with_bing":{"description":"contains keyword search volume normalized with Bing search volume","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfoNormalizedWithInfo"}],"type":["object","null"]},"keyword_info_normalized_with_clickstream":{"description":"contains keyword search volume normalized with clickstream data
","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfoNormalizedWithInfo"}],"type":["object","null"]},"keyword_properties":{"description":"additional information about the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordProperties"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"search_intent_info":{"description":"search intent info for the returned keyword
learn about search intent in this help center article","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchIntentInfo"}],"type":["object","null"]},"search_partners":{"description":"indicates data for Google and partner sites
if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search;
if false, the results are returned for Google search sites only","type":["boolean","null"]},"serp_info":{"description":"SERP data
the value will be null if you didn't set the field include_serp_info to true in the POST array or if there is no SERP data for this keyword in our database","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordOverviewLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordSuggestionsLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"offset":{"description":"current offset value","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"seed_keyword":{"description":"keyword in a POST array","type":["string","null"]},"seed_keyword_data":{"description":"keyword data for the seed keyword
fields in this object are identical to those of the items array","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordSuggestionsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveItem":{"properties":{"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"ranked_serp_element":{"description":"contains data on the domain's SERP element found for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlayRankedSerpElementInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveResultInfo":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"items":{"description":"contains data related to the ranking keywords for the app specified in the app_id field","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForAppLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForCategoriesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForCategoriesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForCategoriesLiveResultInfo":{"properties":{"items":{"description":"contains keyword ideas and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"offset":{"description":"current offset value","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"seed_categories":{"description":"categories in a POST array","items":{"type":["integer","null"]},"type":["array","null"]},"total_count":{"description":"the total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForCategoriesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForCategoriesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForSiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForSiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForSiteLiveResultInfo":{"properties":{"items":{"description":"contains keyword ideas and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"offset":{"description":"current offset value","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]},"total_count":{"description":"total number of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleKeywordsForSiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleKeywordsForSiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveItem":{"properties":{"intersection_result":{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},"description":"contains data on the SERP elements found for the returned keyworddata will be provided in separate arrays for each URL you specified in the pages object when setting a task;depending on the number of specified URLs, it can contain from 1 to 20 arrays named respectively","type":["object","null"]},"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveResultInfo":{"properties":{"exclude_pages":{"description":"URLs you specified in a POST array that will be excluded from the results","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"contains keywords, relevant SERP elements and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages":{"additionalProperties":{"type":["string","null"]},"description":"URLs you specified a POST array","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGooglePageIntersectionLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveItem":{"properties":{"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"ranked_serp_element":{"description":"contains data on the domain's SERP element found for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RankedSerpElement"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveResultInfo":{"properties":{"items":{"description":"contains ranked keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"ranking data relevant to the specified domain or webpage
ranking data is provided by the rank_group parameters that show the result’s rank considering only equivalent SERP elements","type":["object","null"]},"metrics_absolute":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"ranking data relevant to the specified domain or webpage
ranking data is provided by the rank_absolute parameters that indicate the result’s position among all SERP elements","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain or webpage in a POST array","type":["string","null"]},"total_count":{"description":"total number of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRankedKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveItem":{"properties":{"depth":{"description":"keyword search depth","type":["integer","null"]},"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"properties":{"avg_backlinks_info":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvgBacklinksInfo"}],"type":["object","null"]},"search_intent_info":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchIntentInfo"}],"type":["object","null"]}},"type":["object","null"]},"related_keywords":{"description":"list of related keywords
represents the list of search queries which are related to the keyword returned in the array above","items":{"type":["string","null"]},"type":["array","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"seed_keyword":{"description":"keyword in a POST array","type":["string","null"]},"seed_keyword_data":{"description":"keyword data for the seed keyword
fields in the array are identical to that of keyword_data","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRelatedKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveItem":{"properties":{"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"rankings and traffic metrics for the relevant page","type":["object","null"]},"page_address":{"description":"absolute URL of the relevant page","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveResultInfo":{"properties":{"items":{"description":"relevant pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"target domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleRelevantPagesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveItem":{"properties":{"keyword":{"description":"target keyword in a POST array","type":["string","null"]},"keyword_intent":{"description":"search intent data relevant for the specified keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordIntentInfo"}],"type":["object","null"]},"secondary_keyword_intents":{"description":"contains objects with other possible search intents for the specified keyword","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordIntentInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveResultInfo":{"properties":{"items":{"description":"array of items with relevant traffic estimation data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSearchIntentLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveItem":{"properties":{"avg_position":{"description":"the average position of the domain for the specified keywords
the arithmetic mean of values in the keywords_positions array","format":"float","type":["number","null"]},"domain":{"description":"domain name of the detected SERP competitor","type":["string","null"]},"etv":{"description":"estimated traffic volume
represents the estimated monthly traffic that specified keywords are driving to the website
calculated as the sum of the products of the specified keywords' search volume values and CTR (click-through-rate) rates at certain positions in SERP
learn more about how the metric is calculated in this help center article","type":["number","null"]},"keywords_count":{"description":"the number of specified keywords the domain has positions for in SERPs","format":"int64","type":["integer","null"]},"keywords_positions":{"additionalProperties":{"items":{"type":["integer","null"]},"type":["array","null"]},"description":"keyword positions
SERP positions the related domain holds in SERP for the specified keywords","type":["object","null"]},"median_position":{"description":"the median position of the domain for the specified keywords
the median of the values in the keywords_positions array","type":["number","null"]},"rating":{"description":"the margin between the greatest possible and actual keyword positions
represents the relative visibility rate of the domain in SERP for the specified keywords
calculated as sum(100-keywords_positions)","type":["number","null"]},"relevant_serp_items":{"description":"the number of SERP elements relevant to the domain
represents the number of search results in SERP relevant to the domain for the specified keywords","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"visibility":{"description":"SERP visibility rate
represents the website visibility rate based on the SERP positions of the specified keywords
Keywords with positions in the range from 1 to 10 are assigned the visibility index from 1 to 0.1, respectively
Keywords with positions in the range from 11 to 20 have the fixed visibility index of 0.05
keywords with positions from 20 to 100 have the visibility index equal to 0","type":["number","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveResultInfo":{"properties":{"items":{"description":"contains detected SERP competitors and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"seed_keywords":{"description":"keywords specified in the request
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","items":{"type":["string","null"]},"type":["array","null"]},"total_count":{"description":"the total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSerpCompetitorsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveItem":{"properties":{"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsMetricsInfo"},"description":"ranking data relevant to subdomain","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"subdomain":{"description":"returned subdomain","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveResultInfo":{"properties":{"items":{"description":"contains subdomains and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"target":{"description":"domain in a POST array","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleSubdomainsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleTopSearchesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleTopSearchesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleTopSearchesLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"offset":{"description":"current offset value","type":["integer","null"]},"offset_token":{"description":"offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsGoogleTopSearchesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsGoogleTopSearchesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphCarouselItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:
action:listen_artist","type":["string","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphDescriptionItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphLinkElementInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"description content","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphExpandedItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:
action:listen_artist","type":["string","null"]},"expanded_element":{"description":"link of the element","type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphImagesItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphImagesElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphListItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:
action:listen_artist","type":["string","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphPartItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:
action:listen_artist","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"description content","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphRowItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:
action:listen_artist","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"description content","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsKnowledgeGraphShoppingItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:
action:listen_artist","type":["string","null"]},"items":{"description":"historical SERPs and related data found in the database","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphShoppingElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsMetricsInfo":{"properties":{"clickstream_age_distribution":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of clickstream-based metrics by age
to retrieve results for this field, the parameter include_clickstream_data must be set to true
learn more about how the metric is calculated in this help center article","type":["object","null"]},"clickstream_etv":{"description":"estimated traffic volume based on clickstream data
calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for
to retrieve results for this field, the parameter include_clickstream_data must be set to true
learn more about how the metric is calculated in this help center article","format":"double","type":["number","null"]},"clickstream_gender_distribution":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of estimated clickstream-based metrics by gender
to retrieve results for this field, the parameter include_clickstream_data must be set to true
learn more about how the metric is calculated in this help center article","type":["object","null"]},"count":{"description":"total count of organic SERPs that contain the domain or subdomain","format":"int64","type":["integer","null"]},"estimated_paid_traffic_cost":{"description":"estimated cost of converting organic search traffic into paid
represents the estimated monthly cost (USD) of running ads for all keywords in the category that the domain or subdomain ranks for
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
learn more about how the metric is calculated in this help center article","type":["number","null"]},"etv":{"description":"estimated traffic volume
estimated organic monthly traffic to the domain or subdomain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the domain or subdomain ranks for
learn more about how the metric is calculated in this help center article","type":["number","null"]},"is_down":{"description":"rank went down
indicates how many ranked elements of the indicated target went down","type":["integer","null"]},"is_lost":{"description":"lost ranked elements
indicates how many ranked elements of the indicated target were previously presented in SERPs, but weren't found during the last check","type":["integer","null"]},"is_new":{"description":"number of new ranked elements
indicates how many new ranked elements were found for the indicated target","type":["integer","null"]},"is_up":{"description":"rank went up
indicates how many ranked elements of the indicated target went up","type":["integer","null"]},"pos_1":{"description":"number of organic SERPs where the domain or subdomain ranks #1","type":["integer","null"]},"pos_11_20":{"description":"number of organic SERPs where the domain or subdomain ranks #11-20","type":["integer","null"]},"pos_21_30":{"description":"number of organic SERPs where the domain or subdomain ranks #21-30","type":["integer","null"]},"pos_2_3":{"description":"number of organic SERPs where the domain or subdomain ranks #2-3","type":["integer","null"]},"pos_31_40":{"description":"number of organic SERPs where the domain or subdomain ranks #31-40","type":["integer","null"]},"pos_41_50":{"description":"number of organic SERPs where the domain or subdomain ranks #41-50","type":["integer","null"]},"pos_4_10":{"description":"number of organic SERPs where the domain or subdomain ranks #4-10","type":["integer","null"]},"pos_51_60":{"description":"number of organic SERPs where the domain or subdomain ranks #51-60","type":["integer","null"]},"pos_61_70":{"description":"number of organic SERPs where the domain or subdomain ranks #61-70","type":["integer","null"]},"pos_71_80":{"description":"number of organic SERPs where the domain or subdomain ranks #71-80","type":["integer","null"]},"pos_81_90":{"description":"number of organic SERPs where the domain or subdomain ranks #81-90","type":["integer","null"]},"pos_91_100":{"description":"number of organic SERPs where the domain or subdomain ranks #91-100","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsStatusInfo":{"properties":{"date_update":{"description":"update date of the Google endpoints
indicates the last date when the Google endpoints of DataForSEO Labs API were updated;
example:2022-05-16","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsStatusResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsStatusTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsStatusResultInfo":{"properties":{"amazon":{"description":"update information for the Amazon endpoints","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsStatusInfo"}],"type":["object","null"]},"bing":{"description":"update information for the Bing endpoints","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsStatusInfo"}],"type":["object","null"]},"google":{"description":"update information for the Google endpoints","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsStatusInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsStatusTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoLabsStatusResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoLabsleAppCompetitorsLiveItem":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"avg_position":{"description":"average position of the app in Google Play SERP
Note: average position is calculated for intersected keywords only;
the value for a given application may differ when combined with different target applications","format":"float","type":["number","null"]},"competitor_metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_AppMetricsInfo"},"description":"metrics for intersecting keywords
ranking data relevant to the keywords that the provided competitor application shares with the app in a POST request;
note: in this array ranking data is provided for the returned competitor's app_id","type":["object","null"]},"full_metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_AppMetricsInfo"},"description":"metrics for all keywords of the application
full overview of ranking data relevant to all keywords that the provided app_id is ranking for","type":["object","null"]},"intersections":{"description":"number of intersecting keywords","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"sum_position":{"description":"sum of all app positions in Google Play SERP
Note: sum position is calculated for intersected keywords only;
the value for a given application may differ when combined with different target applications","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsleAppIntersectionLiveItem":{"properties":{"intersection_result":{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlaySearchOrganic"}],"type":["object","null"]},"description":"contains SERP data for the returned keyword
data will be provided in separate arrays for each app ID you specified in the app_ids object when setting a task;
depending on the number of specified app IDs, it can contain from 1 to 20 arrays named respectively","type":["object","null"]},"keyword_data":{"description":"keyword data for the returned keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordDataInfo"}],"type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoLabsleBulkAppMetricsLiveItem":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"metrics":{"additionalProperties":{"$ref":"#/components/schemas/Response0A3E90081762_AppMetricsInfo"},"description":"metrics for the ranking keywords of the app
ranking data relevant to the keywords that the provided application ranks for on Google Play","type":["object","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DataforseoTrendsDataInfo":{"properties":{"keyword":{"description":"relevant keyword for which demographic data is provided","type":["string","null"]},"values":{"description":"contains age range and corresponding keyword popularity values","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DemographyItemValueInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DataforseoTrendsDataforseoTrendsGraphElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataDataforseoTrendsItem"}],"type":["object","null"]},{"properties":{"averages":{"items":{"type":["integer","null"]},"type":["array","null"]},"data":{"description":"contains the same parameters that you specified in the POST request
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsGraphDataTrendsGraphDataInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoTrendsDemographyElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataDataforseoTrendsItem"}],"type":["object","null"]},{"properties":{"demography":{"description":"demographic breakdown of keyword popularity data per each specified term
conains keyword popularity data by age and gender","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Demography"}],"type":["object","null"]},"demography_comparison":{"description":"comparison of demographic data on keyword popularity for the specified parameters
conains keyword popularity data by age and gender
if you specified a single keyword, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DemographyComparisonInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoTrendsGraphDataTrendsGraphDataInfo":{"properties":{"date_from":{"description":"start date of the corresponding time range
in the UTC format: \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"end date of the corresponding time range
in the UTC format: \"yyyy-mm-dd\"","type":["string","null"]},"timestamp":{"description":"a point in time in the Unix time format","type":["integer","null"]},"values":{"description":"relative keyword popularity rate at a specific timestamp
represents the keyword popularity rate over the given time range
if you specify more than one keyword, the values will be averaged to the highest value across all specified keywords
a value of 100 is the peak popularity for the term. A value of 50 means that the term is half as popular. A score of 0 means there was not enough data for this term","items":{"type":["integer","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DataforseoTrendsSubregionInterestsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataDataforseoTrendsItem"}],"type":["object","null"]},{"properties":{"interests":{"description":"subregional keyword popuarity data for each specified term","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsinterestsInfo"}],"type":["object","null"]},"type":["array","null"]},"interests_comparison":{"description":"comparison of data on subregional keyword popularity for the specified parameters
if you specified a single keyword, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_InterestsComparison"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DataforseoTrendsinterestsInfo":{"properties":{"keyword":{"description":"relevant keyword
the data included in the values element is based on this keyword","type":["string","null"]},"values":{"description":"contains data on relative keyword popularity by country or region","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsinterestsValuesInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DataforseoTrendsinterestsValuesInfo":{"properties":{"geo_id":{"description":"location identifier
you can use this field for matching obtained results with location parameters specified in the request
see the full list of available locations with their geo_id here or by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
example:US-NY","type":["string","null"]},"geo_name":{"description":"location name
you can use this field for matching obtained results with location parameters specified in the request
see the full list of available locations with their geo_name here or by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
example:Andorra","type":["string","null"]},"value":{"description":"relative keyword popularity rate in a given location
represents location-specific keyword popularity rate over the specified time range;
using this value you can understand how popular a keyword is in one location compared to another location;
calculation: we determine the highest popularity value for the relevant keyword across all locations, and then express all other values as a percentage of that highest value (100);
a value of 100 is the highest popularity for the term
a value of 50 means that the term is half as popular
a value of 0 means there was not enough data for this term","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_Dataset":{"properties":{"area_covered":{"description":"the list of areas covered in the dataset
for example: Africa, Global","items":{"type":["string","null"]},"type":["array","null"]},"authors":{"description":"the list of authors of the dataset","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AuthorsElement"}],"type":["object","null"]},"type":["array","null"]},"dataset_description":{"description":"description of the dataset","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DatasetDescription"}],"type":["object","null"]},"dataset_id":{"description":"ID of the dataset","type":["string","null"]},"dataset_providers":{"description":"the list of institutions that provided the dataset","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"formats":{"description":"the list of file formats of the dataset","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FormatsElement"}],"type":["object","null"]},"type":["array","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"licenses":{"description":"the list of licenses issued to the dataset","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"sitelinks
the links shown below some of Google Dataset's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"period_covered":{"description":"period covered in the dataset","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PeriodCovered"}],"type":["object","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"related_article":{"description":"link to related article
link to the published article that is related to the dataset","type":["string","null"]},"scholarly_articles_url":{"description":"url of scholarly articles
link to the list of scholarly articles on Google Scholar
example: https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22","type":["string","null"]},"scholarly_citations_count":{"description":"count of articles that refer to the dataset","format":"int64","type":["integer","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"unique_identifier":{"description":"digital identifier of an object
unique digital identifier of the dataset
example: https://doi.org/10.5061/dryad.hmgqnk9m3","type":["string","null"]},"updated_date":{"description":"date and time when the result was last updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-11-27 02:00:00 +00:00","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DatasetDescription":{"properties":{"links":{"description":"links featured in the 'dataset_description'","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"text of the description","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DeliveryInfo":{"properties":{"delivery_date_from":{"description":"earliest delivery date
the earliest date when the product can be shipped, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00","type":["string","null"]},"delivery_date_to":{"description":"latest delivery date
the latest date when the product can be delivered, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00","type":["string","null"]},"delivery_message":{"description":"delivery information
message accompanying the delivery information as posted by the seller","type":["string","null"]},"delivery_price":{"description":"price for the delivery
price of the delivery based on the location you specified in the POST request;
if free delivery is available, the value is null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"fastest_delivery_date_from":{"description":"earliest free delivery date
the earliest date when the product can be delivered with a fast delivery option, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00","type":["string","null"]},"fastest_delivery_date_to":{"description":"latest free delivery date
the latest date when the product can be delivered with a fast delivery option, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00","type":["string","null"]}},"type":"object"},"Response0A3E90081762_Demography":{"properties":{"age":{"description":"distribution of keyword popularity by age","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsDataInfo"}],"type":["object","null"]},"type":["array","null"]},"gender":{"description":"distribution of keyword popularity by gender","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsDataInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DemographyComparisonInfo":{"properties":{"age":{"additionalProperties":{"items":{"type":["integer","null"]},"type":["array","null"]},"description":"type of element","type":["object","null"]},"gender":{"additionalProperties":{"items":{"type":["integer","null"]},"type":["array","null"]},"description":"type of element","type":["object","null"]}},"type":"object"},"Response0A3E90081762_DemographyItemValueInfo":{"properties":{"type":{"description":"type of element","type":["string","null"]},"value":{"description":"keyword popularity rate within the specified age range
using this value you can understand how popular a keyword is within each age range;
calculation: we determine the highest popularity value for the relevant keyword across all age groups, and then express all other values as a percentage of that highest value (100);
a value of 100 is the highest popularity for the term
a value of 0 means there was not enough data for this term","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DictionarySerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"breadcrumb":{"description":"breadcrumb of the Ad element in SERP","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"keyword":{"description":"keyword highlighted in the result","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"snippet":{"description":"snippet of the element","type":["string","null"]},"text":{"description":"description of the results element in SERP","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL of the Ad element in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DiscussionsAndForumsElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"posts_count":{"description":"number of posts from the discussion on the related source","format":"int64","type":["integer","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DiscussionsAndForumsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DiscussionsAndForumsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveItem":{"description":"items array","properties":{"categories_count":{"description":"technology categories count
number of domains that match the parameters you specified and are using technologies from the indicated category","format":"int64","type":["integer","null"]},"category":{"description":"technology category id","type":["string","null"]},"group":{"description":"technology group id","type":["string","null"]},"groups_count":{"description":"technology groups count
number of domains that match the parameters you specified and are using technologies from the indicated group","format":"int64","type":["integer","null"]},"technologies_count":{"description":"technologies count
number of domains that match the parameters you specified and are using the indicated technology","format":"int64","type":["integer","null"]},"technology":{"description":"technology name","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResultInfo":{"properties":{"items":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":"offset in the results array of returned domains","type":["integer","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesAggregationTechnologiesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAvailableFiltersResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesAvailableFiltersTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAvailableFiltersResultInfo":{"properties":{"aggregation_technologies":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"domains_by_html_terms":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"domains_by_technology":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"technologies_summary":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesAvailableFiltersTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesAvailableFiltersResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainTechnologiesLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainTechnologiesLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainTechnologiesLiveResultInfo":{"properties":{"content_language_code":{"description":"content language
code of the language that content on the target domain is written in","type":["string","null"]},"country_iso_code":{"description":"domain ISO code
ISO code of the country that the target domain is determined to belong to","type":["string","null"]},"description":{"description":"domain meta description","type":["string","null"]},"domain":{"description":"specified domain name","type":["string","null"]},"domain_rank":{"description":"backlink rank of the target domain
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"emails":{"description":"emails of the target
emails indicated on the target website","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"domain language
code of the language that the target domain is determined to be associated with","type":["string","null"]},"last_visited":{"description":"most recent date when our crawler visited the domain
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-10-10 12:57:46 +00:00","type":["string","null"]},"meta_keywords":{"description":"domain meta keywords","items":{"type":["string","null"]},"type":["array","null"]},"phone_numbers":{"description":"phone numbers of the target
contact phone numbers indicated on the target website","items":{"type":["string","null"]},"type":["array","null"]},"social_graph_urls":{"description":"social media links and handles
social media URLs detected in the social graphs of the target website","items":{"type":["string","null"]},"type":["array","null"]},"technologies":{"description":"technologies used by target domain
contains objects with the names of technologies used on the website
see the full list of available technologies structured by groups and categories","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TechnologiesInfo"}],"type":["object","null"]},"title":{"description":"domain meta title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainTechnologiesLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainTechnologiesLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"specified offset value","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
by specifying the unique offset_token when setting a new task, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByLiveItem":{"description":"items array","properties":{"content_language_code":{"description":"content language
code of the language that content on the target domain is written with","type":["string","null"]},"country_iso_code":{"description":"domain ISO code
ISO code of the country that target domain is determined to belong to","type":["string","null"]},"description":{"description":"domain meta description","type":["string","null"]},"domain":{"description":"specified domain name","type":["string","null"]},"domain_rank":{"description":"backlink rank of the target domain
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"emails":{"description":"emails of the target
emails indicated on the target website","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"domain language
code of the language that target domain is determined to be associated with","type":["string","null"]},"last_visited":{"description":"most recent date when our crawler visited the domain
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-10-10 12:57:46 +00:00","type":["string","null"]},"meta_keywords":{"description":"domain meta keywords","items":{"type":["string","null"]},"type":["array","null"]},"phone_numbers":{"description":"phone numbers of the target
contact phone numbers indicated on the target website","items":{"type":["string","null"]},"type":["array","null"]},"social_graph_urls":{"description":"social media links and handles
social media URLs detected in the social graphs of the target website","items":{"type":["string","null"]},"type":["array","null"]},"technologies":{"description":"technologies used by target domain
contains objects with the names of technologies used on the website;
to get a full list of technologies and their structure, refer to the technologies endpoint","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TechnologiesInfo"}],"type":["object","null"]},"title":{"description":"domain meta title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByTechnologyLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByTechnologyLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByTechnologyLiveResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"offset":{"description":"specified offset value","type":["integer","null"]},"offset_token":{"description":"token for subsequent requests
by specifying the unique offset_token when setting a new task, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent task","type":["string","null"]},"total_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByTechnologyLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesDomainsByTechnologyLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_name":{"description":"full name of the location","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesResultInfo":{"properties":{"groups":{"description":"array of technology groups","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Groups"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesSummaryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesSummaryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesSummaryLiveResultInfo":{"properties":{"content_languages":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by content language
contains content language codes and number of websites per language","type":["object","null"]},"countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by country
contains country codes and number of websites per country","type":["object","null"]},"keywords":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by keywords
contains keywords found in the websites' titles, descriptions or meta keywords, and number of websites using each keyword","type":["object","null"]},"languages":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by language
contains language codes and number of websites per language","type":["object","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesSummaryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesSummaryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologiesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveItem":{"description":"items array","properties":{"countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by country
contains country codes and number of websites per country","type":["object","null"]},"date":{"description":"date for which the data is provided","type":["string","null"]},"domains_count":{"description":"number of domains that use the specified technology","format":"int64","type":["integer","null"]},"domains_rank":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by backlink rank
contains domain rank ranges and number of websites per range
learn more about rank and how it is calculated in this help center article","type":["object","null"]},"languages":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"distribution of websites by language
contains language codes and number of websites per language","type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveResultInfo":{"properties":{"date_from":{"description":"starting date of the time range","type":["string","null"]},"date_to":{"description":"ending date of the time range","type":["string","null"]},"items":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"type":["integer","null"]},"technology":{"description":"target technology","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsTechnologiesTechnologyStatsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisAvailableFiltersResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsWhoisAvailableFiltersTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisAvailableFiltersResultInfo":{"properties":{"overview":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisAvailableFiltersTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsWhoisAvailableFiltersResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveItem":{"description":"items array","properties":{"backlinks_info":{"description":"backlink data for the returned domain","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BacklinksInfo"}],"type":["object","null"]},"changed_datetime":{"description":"date and time when the domain entry was changed
date and time (in the ISO 8601 format) when the domain entry was last modified
example: \"2021-01-14 08:36:28 +00:00\"","type":["string","null"]},"created_datetime":{"description":"date and time of registration
date and time (in the ISO 8601 format) when the domain was first registered
example: \"1997-03-29 03:00:00 +00:00\"","type":["string","null"]},"domain":{"description":"domain name","type":["string","null"]},"epp_status_codes":{"description":"extensive provisioning protocol status codes
the status of a domain name registration as defined by ICANN","items":{"type":["string","null"]},"type":["array","null"]},"expiration_datetime":{"description":"date and time when the domain will expire
date and time (in the ISO 8601 format) when the domain is due to expire
example: \"2022-11-26 17:21:23 +00:00\"","type":["string","null"]},"first_seen":{"description":"date and time when our crawler found the domain for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: \"2019-11-15 12:57:46 +00:00\"","type":["string","null"]},"metrics":{"description":"ranking data relevant to the specified domain","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MetricsBundleInfo"}],"type":["object","null"]},"registered":{"description":"domain registration status
if false, the domain name registration has expired
Note: expired domains will remain in the database for only a short period of time","type":["boolean","null"]},"registrar":{"description":"domain registrar
if null, the domain registrar is unknown
example:NameCheap, Inc.","type":["string","null"]},"tld":{"description":"top-level domain
top-level domain in the DNS root zone","type":["string","null"]},"updated_datetime":{"description":"date and time when the domain was updated
date and time (in the ISO 8601 format) when the domain was last updated
example: \"2021-01-29 13:59:38 +00:00\"","type":["string","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveResultInfo":{"properties":{"items":{"description":"contains ranking and traffic data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"offset":{"description":" results offset value specified in POST request","type":["integer","null"]},"offset_token":{"type":["string","null"]},"total_count":{"description":"total amount of results in our database relevant to your request","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainAnalyticsWhoisOverviewLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_DomainInfo":{"properties":{"canonicalization_status_code":{"description":"status code returned by a canonicalized page
the checkup of the server behavior when our crawler tries to access the website via IP;
in most cases, it is recommended that canonicalized pages respond with a 301 or 302 status code","type":["integer","null"]},"checks":{"additionalProperties":{"type":["boolean","null"]},"description":"website checks
other on-page check-ups related to the website","type":["object","null"]},"cms":{"description":"content management system
content management system identified on a website
the content of_the generator_meta tag
the data is taken from the first random page that returns the 200 response code
if our crawler was unable to identify the cms, the value would be nulln","type":["string","null"]},"crawl_end":{"description":"time when the crawling ended
date and time when the crawling was finished
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00
Note: informative only if \"crawl_progress\" is \"finished\"
if \"crawl_progress\" is in_progress, the value will be null","type":["string","null"]},"crawl_start":{"description":"time when the crawling start
date and time when the website was sent for crawling
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"directory_browsing_status_code":{"description":"status code returned by a directory
the status code returned by a directory page on a target website
in most cases, it is recommended that directories respond with a 403 or 401 status code","type":["integer","null"]},"extended_crawl_status":{"description":"crawl status and errors
indicates the reason why a website was not crawled;
can take the following values:no_errors - no crawling errors were detected;site_unreachable - our crawler could not reach a website and thus was not able to obtain a status code;invalid_page_status_code - status code of the first crawled page >= 400;forbidden_meta_tag - the first crawled page contains the <meta robots=\"noindex\"> tag;forbidden_robots - robots.txt forbids crawling the page;forbidden_http_header - HTTP header of the page contains \"X-Robots-Tag: noindex\" ;too_many_redirects - the first crawled page has more than 10 redirects;unknown - the reason is unknown","type":["string","null"]},"ip":{"description":"domain ip address","type":["string","null"]},"main_domain":{"description":"root domain name","type":["string","null"]},"name":{"description":"domain name","type":["string","null"]},"page_not_found_status_code":{"description":"status code returned by a non-existent page
in most cases, it is recommended a server returns a 404 response code","type":["integer","null"]},"server":{"description":"website server
the version of the server detected on a website
the content of the server header
the information is taken from the first page which response code is 200","type":["string","null"]},"ssl_info":{"description":"ssl certificate info
information about the Secure Sockets Layer protocol detected on a website","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SslInfo"}],"type":["object","null"]},"total_pages":{"description":"total crawled pages
the total number of crawled pages","format":"int64","type":["integer","null"]},"total_uncrawlable_resources":{"description":"total uncrawlable resources
the total number of resources that could not be crawled;
the resource is considered uncrawlable when the actual content type of the resource doesn't match the content type expected by the crawler","format":"int64","type":["integer","null"]},"www_redirect_status_code":{"description":"redirect status code
the status code of the www to non-www redirect
in most cases, it is recommended that redirect returns a 301 status code","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_DuplicatePageInfo":{"properties":{"page":{"description":"information about the page with duplicate content","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageHtmlResourceItem"}],"type":["object","null"]},"type":["array","null"]},"similarity":{"type":["integer","null"]}},"type":"object"},"Response0A3E90081762_EventsElement":{"properties":{"snippet":{"description":"text alongside the link title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_EventsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_EventsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ExploreBrandsElement":{"properties":{"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"image_url":{"description":"URL of the image","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ExploreBrandsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ExploreBrandsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of a given link element","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_FaqBox":{"deprecated":true,"properties":{"items":{"description":"contains arrays of specific images","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FaqBoxElement"}],"type":["object","null"]},"type":["array","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_FaqBoxElement":{"deprecated":true,"properties":{"description":{"description":"description of the hotel booking element","type":["string","null"]},"links":{"description":"link of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the link","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_FeaturedSnippetSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"breadcrumb":{"description":"breadcrumb of the ad element in SERP","type":["string","null"]},"description":{"description":"description of the ad element in SERP","type":["string","null"]},"domain":{"description":"domain of the ad element in SERP","type":["string","null"]},"featured_title":{"description":"title","type":["string","null"]},"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements found in SERPnote values are returned in the ascending order, with values corresponding to advanced SERP features omitted from the results;
to get all items (including SERP features and rich snippets) with their positions, please refer to the Google Organiс Advanced SERP endpoint","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the ad element in SERP","type":["string","null"]},"url":{"description":"relevant URL of the ad element in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_FetchTiming":{"properties":{"duration_time":{"description":"total time it takes until a browser receives a complete response from a server (in milliseconds)","type":["integer","null"]},"fetch_end":{"description":"time to complete downloading the HTML resourcethe amount of time the browser needs to complete downloading a page","type":["integer","null"]},"fetch_start":{"description":"time to start downloading the HTML resourcethe amount of time the browser needs to start downloading a page","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_FindResultsOnElement":{"properties":{"domain":{"description":"domain where a link points","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_FindResultsOnSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FindResultsOnElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_FormatsElement":{"properties":{"format":{"description":"type of file format of the dataset
for example: zip, html, csv","type":["string","null"]},"size":{"description":"file size in bytes","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_FoundOnWebElement":{"properties":{"image":{"description":"image of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"subtitle":{"description":"subtitle of the element","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_FoundOnWebSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FoundOnWebElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]},"related_searches":{"description":"search queries related to the elment","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of a given link element","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_GeminiImagesElement":{"properties":{"alt":{"description":"alt tag of the image","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GeminiImagesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseGeminiLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of Gemini results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GeminiImagesElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GeminiTableElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseGeminiLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"original_text":{"description":"unformatted text content of the element","type":["string","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GeminiTextElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseGeminiLlmScraperElementItem"}],"type":["object","null"]},{"properties":{"original_text":{"description":"unformatted text content of the element","type":["string","null"]},"sources":{"description":"array of sources","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SourceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleBusinessAnswerElement":{"properties":{"answer_id":{"description":"ID of the answer","type":["string","null"]},"answer_text":{"description":"current text of the answer","type":["string","null"]},"original_answer_text":{"description":"original text of the answer","type":["string","null"]},"profile_image_url":{"description":"URL of the user's profile image","type":["string","null"]},"profile_name":{"description":"displayed name of the user","type":["string","null"]},"profile_url":{"description":"URL of the user's profile","type":["string","null"]},"time_ago":{"description":"estimated time when the answer was posted","type":["string","null"]},"timestamp":{"description":"exact time when the answer was posted","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleBusinessInfo":{"properties":{"additional_categories":{"description":"additional business categories
additional Google My Business categories that describe the services provided by the business entity in more detail","items":{"type":"string"},"type":["array","null"]},"address":{"description":"address of the business entity","type":["string","null"]},"address_info":{"description":"object containing address components of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AddressInfo"}],"type":["object","null"]},"attributes":{"description":"service details in a form of user-reviewed checks;
service details of a business entity displayed in a form of checks and based on user feedback and business category","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataAttributesInfo"}],"type":["object","null"]},"book_online_url":{"description":"URL in the 'book online' button of the element
URL directing users to the online booking or order page of the business entity","type":["string","null"]},"category":{"description":"business category
Google My Business general category that best describes the services provided by the business entity","type":["string","null"]},"category_ids":{"description":"global category IDs
universal category IDs that do not change based on the selected country","items":{"type":"string"},"type":["array","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews
learn more about the identifier in this help center article","type":["string","null"]},"contact_url":{"description":"URL of the preferred contact page","type":["string","null"]},"contributor_url":{"description":"URL of the user's or entity's Local Guides profile, if available","type":["string","null"]},"description":{"description":"description of the element in SERP
the description of the business entity for which the results are collected","type":["string","null"]},"directory":{"description":"items of the directory
includes information about businesses that are located within the target business establishment and have the same address","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDirectoryInfo"}],"type":["object","null"]},"domain":{"description":"domain of the business entity","type":["string","null"]},"feature_id":{"description":"the unique identifier of the element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"hotel_rating":{"description":"hotel class rating
class ratings range between 1-5 stars, learn more
if there is no hotel class rating information, the value will be null","type":["number","null"]},"is_claimed":{"description":"shows whether the entity is verified by its owner on Google Maps","type":["boolean","null"]},"is_directory_item":{"description":"business establishment is a part of the directory
indicates whether the business establishment is a part of the directory;
if true, the item is a part of the larger directory of businesses with the same address (e.g., a mall or a business centre);
note: if the business establishment is a parent item in the directory, the value will be null","type":["boolean","null"]},"latitude":{"description":"latitude coordinate of the local establishments in google maps
example:\"latitude\": 51.584091","type":["number","null"]},"local_business_links":{"description":"available interactions with the business
list of options to interact with the business directly from search results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseLocalBusinessLink"}],"type":["object","null"]},"type":["array","null"]},"logo":{"description":"URL of the logo featured in Google My Business profile","type":["string","null"]},"longitude":{"description":"longitude coordinate of the local establishment in google maps
example:\"longitude\": -0.31365919999999997","type":["number","null"]},"main_image":{"description":"URL of the main image featured in Google My Business profile","type":["string","null"]},"original_title":{"description":"original title of the element
original title not translated by Google","type":["string","null"]},"people_also_search":{"description":"related business entities","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PeopleAlsoSearch"}],"type":["object","null"]},"type":["array","null"]},"phone":{"description":"phone number of the business entity","type":["string","null"]},"place_id":{"description":"unique place identifier
place id of the local establishment featured in the element
learn more about the identifier in this help center article","type":["string","null"]},"place_topics":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"keywords mentioned in customer reviews
contains most popular keywords related to products/services mentioned in customer reviews of a business entity and the number of reviews mentioning each keyword
example:
\"place_topics\": {
\"egg roll\": 48,
\"birthday\": 33
}
information related to busy hours of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PopularTimes"}],"type":["object","null"]},"position":{"description":"the alignment in SERP","type":["string","null"]},"price_level":{"description":"property price level
can take values: inexpensive, moderate, expensive, very_expensive
if there is no price level information, the value will be null","type":["string","null"]},"questions_and_answers_count":{"type":["integer","null"]},"rank_absolute":{"description":"absolute rank among all the elements","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"rating_distribution":{"additionalProperties":{"format":"Int64","type":["integer","null"]},"description":"the distribution of ratings of the business entity
the object displays the number of 1-star to 5-star ratings, as reviewed by users","type":["object","null"]},"services":{"description":"list of services offered by the business","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataServiceInfo"}],"type":["object","null"]},"type":["array","null"]},"snippet":{"description":"additional information on the business entity","type":["string","null"]},"title":{"description":"title of the element in SERP
the name of the business entity for which the results are collected","type":["string","null"]},"total_photos":{"description":"total count of images featured in Google My Business profile","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"absolute url of the business entity","type":["string","null"]},"work_time":{"description":"work time details
information related to operational hours of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessWorkHoursInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_GoogleBusinessPost":{"properties":{"author":{"description":"author of the post","type":["string","null"]},"images_url":{"description":"url of an image included in the post","type":["string","null"]},"links":{"description":"links included in the post","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values: right","type":["string","null"]},"post_date":{"description":"date when a post was published
in the following format:\"mm/dd/yyyy hh:mm:ss\"","type":["string","null"]},"post_text":{"description":"main content of a post","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed updates
absolute position among all present elements","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"snippet":{"description":"additional content of a post","type":["string","null"]},"timestamp":{"description":"time when a post was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"url of a post","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleBusinessQuestionItem":{"properties":{"items":{"description":"array of items
items within google_business_question_item","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleBusinessAnswerElement"}],"type":["object","null"]},"type":["array","null"]},"original_question_text":{"description":"original text of the question","type":["string","null"]},"profile_image_url":{"description":"URL of the user's profile image","type":["string","null"]},"profile_name":{"description":"displayed name of the user","type":["string","null"]},"profile_url":{"description":"URL of the user's profile","type":["string","null"]},"question_id":{"description":"ID of the question","type":["string","null"]},"question_text":{"description":"current text of the question","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the elements","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"time_ago":{"description":"estimated time when the question was posted","type":["string","null"]},"timestamp":{"description":"exact time when the question was posted","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of the question","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleExtendedReviewsSearch":{"properties":{"images":{"description":"images submitted by the reviewer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"local_guide":{"description":"indicates whether the reviewer has a 'local guide' status","type":["boolean","null"]},"original_owner_answer":{"description":"original text of the owner's response
the original response to the review, no auto-translate applied","type":["string","null"]},"original_review_text":{"description":"original content of the review
the original content of the review, no auto-translate applied","type":["string","null"]},"owner_answer":{"description":"text of the owner's response
the owner's response to the review","type":["string","null"]},"owner_time_ago":{"description":"publication time
indicates the time (in the 'time ago' format) when the owner submitted the response to the review","type":["string","null"]},"owner_timestamp":{"description":"date and time of the owner's reply to the review
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"photos_count":{"description":"total number of photos submitted by the reviewer","format":"int64","type":["integer","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: right","type":["string","null"]},"profile_image_url":{"description":"URL of the reviewer's profile image","type":["string","null"]},"profile_name":{"description":"profile name of the reviewer","type":["string","null"]},"profile_url":{"description":"URL of the reviewer's profile","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"review_highlights":{"description":"review highlights
contains highlighted review criteria and assessments","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ReviewHighlights"}],"type":["object","null"]},"type":["array","null"]},"review_id":{"description":"the unique identifier of a review on Google
example:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE","type":["string","null"]},"review_text":{"description":"the content of the review","type":["string","null"]},"review_url":{"description":"the URL of the review","type":["string","null"]},"reviews_count":{"description":"total number of reviews submitted by the reviewer","format":"int64","type":["integer","null"]},"source":{"description":"source of the review
contains information about the source where the review was posted","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Source"}],"type":["object","null"]},"time_ago":{"description":"the time of publication
indicates the time (in the 'time ago' format) when the review was listed","type":["string","null"]},"timestamp":{"description":"date and time when a review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the review","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFinanceEarningsCalendarElement":{"properties":{"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"title":{"description":"title of the news article","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the page of the market index on Google Finance","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFinanceFuturesChainElement":{"properties":{"expiration_timestamp":{"description":"futures' date and time of expiration
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"percentage_delta":{"description":"percentage of change in value of the market index","type":["number","null"]},"price":{"description":"price of the market instrument
price of the market instrument at a given timestamp","type":["number","null"]},"price_currency":{"description":"currency of the price value","type":["string","null"]},"price_delta":{"description":"change in price of the market instrument
change in price at a given timestamp","type":["number","null"]},"symbol":{"description":"futures' symbol","type":["string","null"]},"trend":{"description":"growth trend of the market index
possible values: up, down, stable","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFinanceMarketTrendsElement":{"properties":{"news":{"description":"array of items
array contains the following type of items: google_finance_news_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceNewsElement"}],"type":["object","null"]},"type":["array","null"]},"quote":{"description":"object of items
array contains the following type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFinanceMetricsBundleInfo":{"properties":{"cash_and_short_term_investments":{"description":"cash and short-term investments value","type":["number","null"]},"cash_and_short_term_investments_delta":{"description":"change in cash and short-term investments","type":["number","null"]},"cash_from_financing":{"description":"cash from financing/em>","type":["number","null"]},"cash_from_financing_delta":{"description":"change in cash from financing","type":["number","null"]},"cash_from_investing":{"description":"cash from investing","type":["number","null"]},"cash_from_investing_delta":{"description":"change in cash from investing","type":["number","null"]},"cash_from_operations":{"description":"cash from operations","type":["number","null"]},"cash_from_operations_delta":{"description":"change in cash from operations","type":["number","null"]},"earnings_per_share":{"description":"earnings per share value","type":["number","null"]},"earnings_per_share_delta":{"description":"change in earnings per share","type":["number","null"]},"ebitda":{"description":"earnings before interest, taxes, deprecation, amortisation","type":["number","null"]},"ebitda_delta":{"description":"change in ebitda","type":["number","null"]},"effective_tax_rate":{"description":"effective tax rate value","type":["number","null"]},"free_cash_flow":{"description":"free cash flow value","type":["number","null"]},"free_cash_flow_delta":{"description":"change in free cash flow","type":["number","null"]},"net_change_in_cash":{"description":"net change in cash","type":["number","null"]},"net_change_in_cash_delta":{"description":"change in net change in cash","type":["number","null"]},"net_income":{"description":"net income value","type":["number","null"]},"net_income_delta":{"description":"change in net income","type":["number","null"]},"net_profit_margin":{"description":"net profit margin value","type":["number","null"]},"net_profit_margin_delta":{"description":"change in net profit margin","type":["number","null"]},"operating_expense":{"description":"operating expense value","type":["number","null"]},"operating_expense_delta":{"description":"change in operating expense","type":["number","null"]},"price_to_book":{"description":"price to book","type":["number","null"]},"return_on_assets":{"description":"return on assets","type":["number","null"]},"return_on_capital":{"description":"return on capital","type":["number","null"]},"revenue":{"description":"revenue value","type":["number","null"]},"revenue_delta":{"description":"change in revenue","type":["number","null"]},"shares_outstanding":{"description":"outstanding shares value","type":["number","null"]},"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"total_assets":{"description":"total assets value","type":["number","null"]},"total_assets_delta":{"description":"change in total assets","type":["number","null"]},"total_equity":{"description":"total equity value","type":["number","null"]},"total_liabilities":{"description":"total liabilities value","type":["number","null"]},"total_liabilities_delta":{"description":"change in total liabilities","type":["number","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFinanceNewsElement":{"properties":{"image_url":{"description":"featured image URL
URL of the news article's featured image","type":["string","null"]},"quotes":{"description":"market indexes quoted in the news article
information about market indexes quoted in the google_finance_news_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"source":{"description":"name of the news source
name of the website where the news article is published","type":["string","null"]},"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"title":{"description":"title of the news article","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the page of the market index on Google Finance","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFlightsElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleFlightsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFlightsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleHotelsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"cid":{"description":"google-defined client id","type":["string","null"]},"hotel_identifier":{"description":"unique hotel identifier
unique hotel identifier assigned by Google;
example: \"CgoIjaeSlI6CnNpVEAE\"","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleJobsItem":{"properties":{"contract_type":{"description":"employment contract type","type":["string","null"]},"employer_image_url":{"description":"URL to the image used in the job posting","type":["string","null"]},"employer_name":{"description":"name of the employer","type":["string","null"]},"employer_url":{"description":"URL to the employer's website","type":["string","null"]},"job_id":{"description":"ID of the job on Google Jobs","type":["string","null"]},"location":{"description":"location for which the job vacancy is posted","type":["string","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result's snippet in SERP;
in this case, will equal null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"salary":{"description":"the salary indicated in the job vacancy
if the salary isn't indicated, this field will equal null","type":["string","null"]},"source_name":{"description":"original source of the job vacancy","type":["string","null"]},"source_url":{"description":"URL to the original source of the job vacancy","type":["string","null"]},"time_ago":{"description":"indicates how long ago the job vacancy was posted","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GooglePlayInfoOrganic":{"properties":{"app_id":{"description":"ID of the app","type":["string","null"]},"description":{"description":"description of the app","type":["string","null"]},"developer":{"description":"name of the app developer","type":["string","null"]},"developer_address":{"description":"physical address of the developer","type":["string","null"]},"developer_email":{"description":"email address of the developer","type":["string","null"]},"developer_id":{"description":"ID of the app developer","type":["string","null"]},"developer_url":{"description":"URL to the developer page on Google Play","type":["string","null"]},"developer_website":{"description":"official website of the developer","type":["string","null"]},"genres":{"description":"app genres
contains relevant app categories","items":{"type":["string","null"]},"type":["array","null"]},"icon":{"description":"URL to the app icon","type":["string","null"]},"images":{"description":"app images
contains URLs to the images published on the app page on Google Play","items":{"type":["string","null"]},"type":["array","null"]},"installs":{"description":"number of installs of the app
approximate number of installs as displayed on the app page","type":["string","null"]},"installs_count":{"description":"number of installs of the app
the exact number of installs of the app","format":"int64","type":["integer","null"]},"is_free":{"description":"indicates whether the app is free","type":["boolean","null"]},"last_update_date":{"description":"date and time when the app was last updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"main_category":{"description":"main category of the app","type":["string","null"]},"minimum_os_version":{"description":"minimum OS version required to install the app","type":["string","null"]},"more_apps_by_developer":{"description":"similar apps
information about apps built by the same developer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppsInfo"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values: left","type":["string","null"]},"price":{"description":"price of the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank among all the listed apps
absolute position among all apps on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"average rating of the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"released_date":{"description":"date and time when the app was released
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"reviews_count":{"description":"the total number of reviews the app has","format":"int64","type":["integer","null"]},"similar_apps":{"description":"similar apps
displays apps similar to the app in a POST request","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppsInfo"}],"type":["object","null"]},"type":["array","null"]},"size":{"description":"size of the app","type":["string","null"]},"tags":{"description":"app tags
contains relevant app tags","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the app","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"update_notes":{"description":"update notes
contains the latest update notes from the developer","type":["string","null"]},"url":{"description":"URL to the app page on Google Play","type":["string","null"]},"version":{"description":"current version of the app","type":["string","null"]},"videos":{"description":"app videos
contains URLs to the video published on the app page on Google Play","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_GooglePlayRankedSerpElementInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"previous_updated_time":{"description":"previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-10-15 12:57:46 +00:00;
in this case, will equal null","type":["string","null"]},"se_results_count":{"description":"number of search results for the returned keyword","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"serp_item":{"description":"contains data on the SERP element
the list of supported SERP elements can be found below","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GooglePlaySearchOrganic"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_GooglePlayReviewsSearch":{"properties":{"helpful_count":{"description":"number of helpful votes
indicates how many users considered the review helpful and voted with the thumbs up icon","format":"int64","type":["integer","null"]},"id":{"description":"id of the review","type":["string","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: left","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"responses":{"description":"response from the developer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ResponseDataInfo"}],"type":["object","null"]},"type":["array","null"]},"review_text":{"description":"content of the review","type":["string","null"]},"timestamp":{"description":"date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the review
Google Play doesn't provide an option to title reviews, so this parameter will always equal null","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"user_profile":{"description":"user profile of the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AppUserProfileInfo"}],"type":["object","null"]},"version":{"description":"version of the app
version of the app for which the review is submitted","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GooglePlaySearchOrganic":{"properties":{"app_id":{"description":"id of the app in a POST array","type":["string","null"]},"developer":{"description":"name of the app developer","type":["string","null"]},"developer_url":{"description":"URL to the developer page on Google Play","type":["string","null"]},"icon":{"description":"URL to the app icon","type":["string","null"]},"is_free":{"type":["boolean","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"price":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"average rating of the app","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews of the app","format":"int64","type":["integer","null"]},"title":{"description":"title of the app","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the app page on Google Play","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GooglePostsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"cid":{"description":"google-defined client id","type":["string","null"]},"feature":{"description":"the additional feature of the review","type":["string","null"]},"posts_id":{"description":"the identifier of the google_posts feature","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_GoogleReviewsSearch":{"properties":{"images":{"description":"images submitted by the reviewer","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"local_guide":{"description":"indicates whether the reviewer has a 'local guide' status","type":["boolean","null"]},"original_language":{"description":"original language of the review text","type":["string","null"]},"original_owner_answer":{"description":"original text of the owner's response
the original response to the review, no auto-translate applied","type":["string","null"]},"original_review_text":{"description":"original content of the review
the original content of the review, no auto-translate applied","type":["string","null"]},"owner_answer":{"description":"text of the owner's response
the owner's response to the review","type":["string","null"]},"owner_time_ago":{"description":"publication time
indicates the time (in the 'time ago' format) when the owner submitted the response to the review","type":["string","null"]},"owner_timestamp":{"description":"date and time of the owner's reply to the review
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"photos_count":{"description":"total number of photos submitted by the reviewer","format":"int64","type":["integer","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: right","type":["string","null"]},"profile_image_url":{"description":"URL of the reviewer's profile image","type":["string","null"]},"profile_name":{"description":"profile name of the reviewer","type":["string","null"]},"profile_url":{"description":"URL of the reviewer's profile","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"review_highlights":{"description":"review highlights
contains highlighted review criteria and assessments","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ReviewHighlights"}],"type":["object","null"]},"type":["array","null"]},"review_id":{"description":"the unique identifier of a review on Google
example:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE","type":["string","null"]},"review_text":{"description":"the content of the review","type":["string","null"]},"review_url":{"description":"the URL of the review","type":["string","null"]},"reviews_count":{"description":"total number of reviews submitted by the reviewer","format":"int64","type":["integer","null"]},"time_ago":{"description":"the time of publication
indicates the time (in the 'time ago' format) when the review was listed","type":["string","null"]},"timestamp":{"description":"date and time when a review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the review","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleReviewsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"cid":{"description":"google-defined client id","type":["string","null"]},"feature":{"description":"the additional feature of the review","type":["string","null"]},"place_id":{"description":"the identifier of a place","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the number of reviews","format":"int64","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleShoppingCarouselElement":{"properties":{"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"data_docid":{"description":"unique identifier of the SERP data element
note that there is no full list of possible values as the data_docid is a dynamic value assigned by Google
example:17363035694596624076","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DeliveryInfo"}],"type":["object","null"]},"gid":{"description":"global product identifier on Google Shopping
note that there is no full list of possible values as the gid is a dynamic value assigned by Google
if there are no values, you will get null
example:4702526954592161872
learn more about gid parameter in this help center guide","type":["string","null"]},"price":{"description":"product price
example:384.99","type":["number","null"]},"product_id":{"description":"unique product identifier on Google Shopping
note that there is no full list of possible values as the product_id is a dynamic value assigned by Google
if there are no values, you will get null
example:4485466949985702538
learn more about the parameter in this help center guide","type":["string","null"]},"product_images":{"description":"URLs to the images of the product
the first URL in the array is the featured image of the product","items":{"type":["string","null"]},"type":["array","null"]},"product_rating":{"description":"product rating
the product popularity rate based on product reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"seller":{"description":"name of the seller
the name of the company that placed a corresponding product on Google Shopping","type":["string","null"]},"shopping_url":{"description":"URL to the product page on Google Shopping","type":["string","null"]},"snippet":{"description":"additional information about the result","type":["string","null"]},"special_offer_info":{"description":"special offer from the seller
information on the special offer from the seller, including discount and coupon info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpecialOfferInfo"}],"type":["object","null"]},"tags":{"description":"tags assigned to the product","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"product title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleShoppingCarouselElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleShoppingCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the special offer","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleShoppingPaidElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem"}],"type":["object","null"]},{"properties":{"description":{"description":"description of the product in Google Shopping SERP","type":["string","null"]},"domain":{"description":"domain of the URL
domain of the URL where a special offer is posted
Note: this field is deprecated and will return null","type":["string","null"]},"shop_ad_aclk":{"description":"unique ad click referral parameter
using this parameter you can get a URL of the advertisement in Google Shopping Sellers Ad URL","type":["string","null"]},"title":{"description":"product title","type":["string","null"]},"url":{"description":"URL pointing at special offer page
URL where a special offer is posted
Note: this field is deprecated and will return null","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleShoppingSellersBuyOnGoogleElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingSellersElementItem"}],"type":["object","null"]},{"properties":{"rating":{"description":"shop rating
the shop popularity rate based on product reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleShoppingSellersShopsListElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingSellersElementItem"}],"type":["object","null"]},{"properties":{"displayed_payment_breakdown":{"description":"installment details as displayed in the results
shows how the product price can be broken down into monthly payments, if applicable","type":["string","null"]},"price_multiplier":{"description":"monthly price multiplier
indicates the number of months covered by the monthly payment for the product","type":["integer","null"]},"product_annotation":{"description":"data from annotations and badges with special offers
if there is no annotation for this product, the value will be null
examples: LOW PRICE, SPECIAL OFFER, SALE, PRICE DROP","type":["string","null"]},"product_availability":{"description":"product availability information
product availability information
can take the following values: in_stock, limited_stock, out_of_stock, backordered, pre_order_available, on_display_to_order","type":["string","null"]},"product_condition":{"description":"indicated condition of the product
possible values: Used, Refurbished, New, Pre-owned, null","type":["string","null"]},"rating":{"description":"shop rating
the shop popularity rate based on product reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleShoppingSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem"}],"type":["object","null"]},{"properties":{"additional_specifications":{"additionalProperties":{"type":["string","null"]},"description":"object containing additional url parameters
you can get more details about the product by using this object in the POST request to the Google Shopping Product Specification and Google Shopping Sellers endpoint","type":["object","null"]},"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"data_docid":{"description":"unique identifier of the SERP data element
note that there is no full list of possible values as the data_docid is a dynamic value assigned by Google
example:17363035694596624076","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DeliveryInfo"}],"type":["object","null"]},"description":{"description":"description of the product in Google Shopping SERP","type":["string","null"]},"domain":{"description":"domain of the URL
domain of the URL where a special offer is posted
Note: this field is deprecated and will return null","type":["string","null"]},"gid":{"description":"global product identifier on Google Shopping
note that there is no full list of possible values as the gid is a dynamic value assigned by Google
if there are no values, you will get null
example:4702526954592161872
learn more about gid parameter in this help center guide","type":["string","null"]},"is_best_match":{"description":"\"best match\" label
if the value is true, the product is marked with the \"best match\" label
if there are no values, you will get null","type":["boolean","null"]},"old_price":{"description":"product old price
displayed if the product price has been changed
example:499","type":["number","null"]},"price":{"description":"product price
example:384.99","type":["number","null"]},"price_multiplier":{"description":"price multiplier for instalment plan
indicates the number of months covered by the monthly payment for the product","type":["integer","null"]},"product_id":{"description":"unique product identifier on Google Shopping
note that there is no full list of possible values as the product_id is a dynamic value assigned by Google
if there are no values, you will get null
example:4485466949985702538
learn more about the parameter in this help center guide","type":["string","null"]},"product_images":{"description":"URLs to the images of the product
the first URL in the array is the featured image of the product","items":{"type":["string","null"]},"type":["array","null"]},"product_rating":{"description":"product rating
the product popularity rate based on product reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"reviews_count":{"description":"number of product reviews
indicates the number of reviews left by users on Google Shopping
if there are no values, you will get null","format":"int64","type":["integer","null"]},"seller":{"description":"name of the seller
the name of the company that placed a corresponding product on Google Shopping","type":["string","null"]},"shop_ad_aclk":{"description":"unique ad click referral parameter
using this parameter you can get a URL of the advertisement in Google Shopping Sellers Ad URL","type":["string","null"]},"shop_rating":{"description":"shop rating
the popularity rate of the seller based on user reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"shopping_url":{"description":"URL to the product page on Google Shopping","type":["string","null"]},"snippet":{"description":"additional information about the result","type":["string","null"]},"stores_count_info":{"description":"stores count information
contains information about the number of stores that offer the same product","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_StoresCountInfo"}],"type":["object","null"]},"tags":{"description":"tags assigned to the product","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the element","type":["string","null"]},"url":{"description":"URL pointing at special offer page
URL where a special offer is posted
Note: this field is deprecated and will return null","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleShoppingSponsoredCarouselElement":{"properties":{"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DeliveryInfo"}],"type":["object","null"]},"price":{"description":"product price
example:384.99","type":["number","null"]},"product_images":{"description":"URLs to the images of the product
the first URL in the array is the featured image of the product","items":{"type":["string","null"]},"type":["array","null"]},"product_rating":{"description":"product rating
the product popularity rate based on product reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"seller":{"description":"name of the seller
the name of the company that placed a corresponding product on Google Shopping","type":["string","null"]},"shop_ad_aclk":{"description":"unique ad click referral parameter
using this parameter you can get a URL of the advertisement in Google Shopping Sellers Ad URL","type":["string","null"]},"special_offer_info":{"description":"special offer from the seller
information on the special offer from the seller, including discount and coupon info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpecialOfferInfo"}],"type":["object","null"]},"tags":{"description":"tags assigned to the product","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_GoogleShoppingSponsoredCarouselElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleShoppingSponsoredCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the special offer","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleTrendsGoogleTrendsGraphElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataGoogleTrendsItem"}],"type":["object","null"]},{"properties":{"averages":{"items":{"format":"double","type":["number","null"]},"type":"array"},"data":{"description":"Google Trends data for the specified parameters","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TrendsGraphDataInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleTrendsGoogleTrendsMapElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataGoogleTrendsItem"}],"type":["object","null"]},{"properties":{"data":{"description":"Google Trends data from the corresponding item","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TrendsMapDataInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleTrendsGoogleTrendsQueriesListElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataGoogleTrendsItem"}],"type":["object","null"]},{"properties":{"data":{"description":"Google Trends data from the corresponding item","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ListDataInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GoogleTrendsGoogleTrendsTopicsListElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataGoogleTrendsItem"}],"type":["object","null"]},{"properties":{"data":{"description":"Google Trends data from the corresponding item","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ListDataInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_GpsCoordinatesLocationInfo":{"properties":{"latitude":{"description":"latitude coordinate of the hotel in google maps
example:\"latitude\": 51.584091","type":["number","null"]},"longitude":{"description":"longitude coordinate of the hotel in google maps
example:\"longitude\": -0.31365919999999997","type":["number","null"]}},"type":"object"},"Response0A3E90081762_Graph":{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GraphElement"}],"type":["object","null"]},"type":["array","null"]},"previous_items":{"description":"previous close data
contains stock price data based on the preceding time period","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GraphElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_GraphElement":{"properties":{"date":{"description":"date when the video was published or indexed
example: Apr 26, 2024","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"value":{"description":"the value of the rating","type":["number","null"]}},"type":"object"},"Response0A3E90081762_GraphItems":{"properties":{"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"value":{"description":"point value on graph","type":["number","null"]},"volume":{"description":"volume value on graph","type":["number","null"]}},"type":"object"},"Response0A3E90081762_Groups":{"properties":{"categories":{"description":"technology categories in this group","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TechnologyCategoryInfo"}],"type":["object","null"]},"type":["array","null"]},"id":{"description":"id of the technology group
example:marketing, sales","type":["string","null"]},"title":{"description":"title of the technology group","type":["string","null"]}},"type":"object"},"Response0A3E90081762_HistoricalMetricsBundleInfo":{"properties":{"featured_snippet":{"description":"traffic data from the featured snippet results in Google SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HistoricalMetricsInfo"}],"type":["object","null"]},"type":["array","null"]},"local_pack":{"description":"traffic data from the local pack results in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HistoricalMetricsInfo"}],"type":["object","null"]},"type":["array","null"]},"organic":{"description":"traffic data from organic search","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HistoricalMetricsInfo"}],"type":["object","null"]},"type":["array","null"]},"paid":{"description":"traffic data from paid search","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HistoricalMetricsInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_HistoricalMetricsInfo":{"properties":{"count":{"description":"total count of organic SERPs that contain the domain","format":"int64","type":["integer","null"]},"etv":{"description":"estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain ranks for
learn more about how the metric is calculated in this help center article","type":["number","null"]},"month":{"description":"month for which the data is provided","type":["integer","null"]},"year":{"description":"year for which the data is provided","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_History":{"properties":{"keyword_info":{"description":"historical data for the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfo"}],"type":["object","null"]},"month":{"description":"month","type":["integer","null"]},"year":{"description":"year","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_HotelAboutInfo":{"properties":{"amenities":{"description":"hotel amenities
information about hotel amenities","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelAmenityInfo"}],"type":["object","null"]},"type":["array","null"]},"check_in_time":{"description":"hotel check-in time
check-in time indicated in the hotel listing","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TimeInfo"}],"type":["object","null"]},"check_out_time":{"description":"hotel check-out time
check-out time indicated in the hotel listing","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TimeInfo"}],"type":["object","null"]},"description":{"description":"description of the hotel
the description of the hotel entity for which the results are collected","type":["string","null"]},"domain":{"description":"hotel domain
domain of the hotel's website","type":["string","null"]},"full_address":{"description":"full address of the hotel
address of the hotel indicated in the standardised format","type":["string","null"]},"popular_amenities":{"description":"hotel amenities
information about hotel amenities labelled as \"popular\"","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelAmenityItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sub_descriptions":{"description":"additional description of the hotel
details about the hotel provided in addition to the description","items":{"type":["string","null"]},"type":["array","null"]},"url":{"description":"hotel url
URL to the hotel's website indicated in the listing","type":["string","null"]}},"type":"object"},"Response0A3E90081762_HotelAmenityInfo":{"properties":{"category":{"description":"standardised category of the ammenity","type":["string","null"]},"category_label":{"description":"label of the category","type":["string","null"]},"items":{"description":"specific amenities and details","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelAmenityItemInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_HotelAmenityItemInfo":{"properties":{"amenity":{"description":"standardised amenity name","type":["string","null"]},"amenity_label":{"description":"displayed amenity name","type":["string","null"]},"hint":{"description":"standardised details about the amenity","type":["string","null"]},"hint_label":{"description":"displayed details about the amenity","type":["string","null"]},"is_available":{"description":"indicates whether the amenity is available in the hotel","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_HotelInfoPriceOffer":{"description":"featured price offers","properties":{"currency":{"description":"price currencyUSD is applied by default, unless specified in the POST array","type":["string","null"]},"free_cancellation_until":{"description":"date until free cancellation is available\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nequals null if free cancellation is not available for the selected dates","type":["string","null"]},"max_visitors":{"description":"the maximal number of visitors\nthe maximum number of visitors for which the price offer is valid","type":["integer","null"]},"offer_images":{"description":"price offer images\nURLs of the images featured in the price offer","items":{"type":["string","null"]},"type":["array","null"]},"price":{"description":"price per night","type":["number","null"]},"title":{"description":"title of the hotel","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"url of the price offer\nURL to the page of the website where price offer appears","type":["string","null"]}},"type":"object"},"Response0A3E90081762_HotelLocationInfo":{"properties":{"latitude":{"description":"hotel latitude
latitude coordinates of the hotel's location
example:39.4806397","type":["number","null"]},"location_chain":{"description":"elements of the location chain
additional parameters of each element of the location chain","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocationChain"}],"type":["object","null"]},"type":["array","null"]},"longitude":{"description":"hotel longitude
latitude coordinates of the hotel's location
example:-106.0512973","type":["number","null"]},"maps_url":{"description":"url to the location of the hotel in google maps","type":["string","null"]},"neighborhood":{"description":"name of the neighborhood where the hotel is located","type":["string","null"]},"neighborhood_description":{"description":"description of the neighborhood where the hotel is located","type":["string","null"]},"overall_score":{"description":"overall score of the hotel location
indicates the overall score of the hotel's location in the range from 1 to 5;
calculated based on data from the hotel's proximity to nearby things to do and restaurants, transportation, and airports;
note that the criteria are not weighted equally in the overall score","type":["number","null"]},"score_by_categories":{"additionalProperties":{"format":"double","type":["number","null"]},"description":"category scores of the hotel location
the scores of the hotel's location tied to the categories that indicate the proximity to nearby things to do, restaurants, transportation, and airports;","type":["object","null"]}},"type":"object"},"Response0A3E90081762_HotelPriceInfo":{"properties":{"check_in":{"description":"check-in date and time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"check_out":{"description":"check-out date and time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"currency":{"description":"price currencyUSD is applied by default, unless specified in the POST array","type":["string","null"]},"discount_text":{"description":"text about a discount applied","type":["string","null"]},"items":{"description":"encountered item types
types of search engine results encountered in the items array;
possible item types: hotel_search_item","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelPriceItemInfo"}],"type":["object","null"]},"type":["array","null"]},"price":{"description":"price per night","type":["number","null"]},"price_without_discount":{"description":"full price per night without a discount applied","format":"int64","type":["number","null"]},"prices_by_dates":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PricesByDates"}],"type":["object","null"]},"type":["array","null"]},"visitors":{"description":"number of hotel visitors for this price","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_HotelPriceItemInfo":{"properties":{"currency":{"description":"price currencyUSD is applied by default, unless specified in the POST array","type":["string","null"]},"domain":{"description":"third-party domain\ndomain of the third-party website page with pricing information","type":["string","null"]},"free_cancellation_until":{"description":"date until which free cancellation is available\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nequals null if free cancellation is not available for the selected dates","type":["string","null"]},"is_paid":{"description":"indicates a paid hotel listing
if true, related hotel_search_item is a paid ad
if false, related hotel_search_item is an organic hotel listing","type":["boolean","null"]},"offers":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelInfoPriceOffer"}],"type":["object","null"]},"type":["array","null"]},"official_site":{"type":["boolean","null"]},"price":{"description":"price per night","type":["number","null"]},"title":{"description":"title of the hotel","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"third-party page url\nURL to the third-party website page with pricing information","type":["string","null"]}},"type":"object"},"Response0A3E90081762_HotelReviewInfo":{"properties":{"mentions":{"description":"hotel mentions
information about hotel reviews by criteria","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ReviewMentionInfo"}],"type":["object","null"]},"type":["array","null"]},"other_sites_reviews":{"description":"reviews on third-party sites
reviews from third-party sites","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OtherSitesReviewsInfo"}],"type":["object","null"]},"type":["array","null"]},"rating_distribution":{"additionalProperties":{"format":"Int64","type":["integer","null"]},"description":"rating distribution by votes
the distribution of votes across the rating in the range from 1 to 5","type":["object","null"]},"value":{"description":"overall hotel rating based on customer votes","type":["number","null"]},"votes_count":{"description":"number of customer votes
the number of customer votes included in the calculation of the hotel rating","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_HotelsPackElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"hotel_identifier":{"description":"unique hotel identifier
unique hotel identifier assigned by Google;
example: \"CgoIjaeSlI6CnNpVEAE\"","type":["string","null"]},"is_paid":{"description":"indicates whether the element is an ad","type":["boolean","null"]},"price":{"description":"price indicated in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_HotelsPackSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"date_from":{"description":"starting date of stay
in the format \"year-month-date\"
example:
2019-11-15","type":["string","null"]},"date_to":{"description":"ending date of stay
in the format \"year-month-date\"
example:
2019-11-17","type":["string","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HotelsPackElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_HtmlContentInfo":{"properties":{"automated_readability_index":{"description":"Automated Readability Index","type":["number","null"]},"coleman_liau_readability_index":{"description":"Coleman–Liau Index","type":["number","null"]},"dale_chall_readability_index":{"description":"Dale–Chall Readability Index","type":["number","null"]},"description_to_content_consistency":{"description":"consistency of the meta description tag with the page contentmeasured from 0 to 1","type":["number","null"]},"flesch_kincaid_readability_index":{"description":"Flesch–Kincaid Readability Index","type":["number","null"]},"meta_keywords_to_content_consistency":{"description":"consistency of meta keywordstag with the page contentmeasured from 0 to 1","type":["number","null"]},"plain_text_rate":{"description":"plaintext rate value\nplain_text_size to size ratio","format":"double","type":["number","null"]},"plain_text_size":{"description":"total size of the text on the page measured in bytes","type":["integer","null"]},"plain_text_word_count":{"description":"number of words on the page","type":["integer","null"]},"smog_readability_index":{"description":"SMOG Readability Index","type":["number","null"]},"title_to_content_consistency":{"description":"consistency of the meta title tag with the page contentmeasured from 0 to 1","type":["number","null"]}},"type":"object"},"Response0A3E90081762_HtmlItemInfo":{"properties":{"date":{"description":"date and time when the HTML page was scanned
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"html":{"description":"HTML page","type":["string","null"]},"page":{"description":"serial number of the returned HTML page","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_HunspellInfo":{"properties":{"hunspell_language_code":{"description":"spellcheck language code","type":["string","null"]},"misspelled":{"description":"array of misspelled words","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HunspellMisspelledInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_HunspellMisspelledInfo":{"properties":{"word":{"description":"misspelled word","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ImageUrlInfo":{"properties":{"url":{"description":"URL of the image used in the review","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ImagesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"related_image_searches":{"deprecated":true,"description":"contains keywords and images related to the specified search term
Note: this array is deprecated and always returns null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedImageSearchesElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_IndexHistory":{"properties":{"date":{"description":"date for which index volume data is provided
in the UTC format: \"yyyy-mm-dd\"
example:2021-10-01","type":["string","null"]},"total_backlinks":{"description":"total number of backlinks our database contained on the given date","format":"int64","type":["integer","null"]},"total_pages":{"description":"total number of pages our database contained on the given date","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_InterestsComparison":{"properties":{"absolute_items":{"description":"keyword popularity rates across all locations
values in this array represent percentages relative to the maximum value across all locations","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AbsoluteItems"}],"type":["object","null"]},"type":["array","null"]},"items":{"description":"contains keyword popularity and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AbsoluteItems"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_IntersectionSummaryInfo":{"properties":{"intersections_count":{"description":"total number of intersections","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_JobsElement":{"properties":{"author":{"description":"author","type":["string","null"]},"contract_type":{"description":"contract type","type":["string","null"]},"description":{"description":"link description","type":["string","null"]},"job_posted_time":{"description":"the time when the job was posted","type":["string","null"]},"location":{"description":"location for which the job vacancy is posted","type":["string","null"]},"salary":{"description":"salary","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_JobsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_JobsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordDataInfo":{"properties":{"avg_backlinks_info":{"description":"backlink data for the returned keyword
this object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 webpages ranking organically for the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvgBacklinksInfo"}],"type":["object","null"]},"clickstream_keyword_info":{"description":"clickstream data for the returned keyword
to retrieve results for this field, the parameter include_clickstream_data must be set to true","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ClickstreamKeywordInfo"}],"type":["object","null"]},"keyword":{"description":"returned keyword idea","type":["string","null"]},"keyword_info":{"description":"keyword data for the returned keyword idea","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfo"}],"type":["object","null"]},"keyword_info_normalized_with_bing":{"description":"contains keyword search volume normalized with Bing search volume","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfoNormalizedWithInfo"}],"type":["object","null"]},"keyword_info_normalized_with_clickstream":{"description":"contains keyword search volume normalized with clickstream data
","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordInfoNormalizedWithInfo"}],"type":["object","null"]},"keyword_properties":{"description":"additional information about the keyword","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordProperties"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"search_intent_info":{"description":"search intent info for the returned keyword
learn about search intent in this help center article","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchIntentInfo"}],"type":["object","null"]},"serp_info":{"description":"SERP data
the value will be null if you didn't set the field include_serp_info to true in the POST array or if there is no SERP data for this keyword in our database","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_KeywordInfo":{"properties":{"categories":{"description":"product and service categories
you can download the full list of possible categories","items":{"type":"integer"},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword. This value is based on Google Ads data and can be between 0 and 1 (inclusive)","type":["number","null"]},"competition_level":{"description":"competition level
represents the relative level of competition associated with the given keyword in paid SERP only;
possible values: LOW, MEDIUM, HIGH
if competition level is unknown, the value is null;
learn more about the metric in this help center article","type":["string","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"search_volume":{"description":"average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea on google.com","format":"int64","type":["integer","null"]},"search_volume_trend":{"description":"search volume trend changes
represents search volume change in percent compared to the previous period","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeTrend"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_KeywordInfoNormalizedWithInfo":{"properties":{"is_normalized":{"description":"keyword info is normalized\nif true, values are normalized with Bing data","type":["boolean","null"]},"last_updated_time":{"description":"date and time when the dataset was updated\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nexample:\n2019-11-15 12:57:46 +00:00","type":["string","null"]},"monthly_searches":{"description":"monthly search volume rates\narray of objects with search volume rates in a certain month of a year","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_volume":{"description":"current search volume rate of a keyword","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordIntentInfo":{"properties":{"label":{"description":"search intent name
possible values: informational, navigational, commercial, transactional","type":["string","null"]},"probability":{"description":"search intent probability1 indicates the highest probability","type":["number","null"]}},"type":"object"},"Response0A3E90081762_KeywordKpi":{"properties":{"desktop":{"description":"keyword data aggregated for desktop devices
if there is no data, then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordKpiItemInfo"}],"type":["object","null"]},"type":["array","null"]},"mobile":{"description":"keyword data aggregated for mobile devices
if there is no data, then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordKpiItemInfo"}],"type":["object","null"]},"type":["array","null"]},"tablet":{"description":"keyword data aggregated for tablet devices
if there is no data, then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordKpiItemInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_KeywordKpiItemInfo":{"properties":{"ad_position":{"description":"represents the position of the relevant ad in SERP
can take the following values:FirstPage1: The first ad to appear on the right side of the first search results pageFirstPage2: The second ad to appear on the right side of the first search results pageFirstPage3: The third ad to appear on the right side of the first search results pageFirstPage4: The fourth ad to appear on the right side of the first search results pageFirstPage5: The fifth ad to appear on the right side of the first search results pageFirstPage6: The sixth ad to appear on the right side of the first search results pageFirstPage7: The seventh ad to appear on the right side of the first search results pageFirstPage8: The eighth ad to appear on the right side of the first search results pageFirstPage9: The ninth ad to appear on the right side of the first search results pageFirstPage10: The tenth ad to appear on the right side of the first search results pageMainLine1: The first ad to appear at the top of the search results pageMainLine2: The second ad to appear at the top of the search results pageMainLine3: The third ad to appear at the top of the search results pageMainLine4: The fourth ad to appear at the top of the search results page","type":["string","null"]},"average_bid":{"description":"average bid of the keyword","format":"double","type":["number","null"]},"average_cpc":{"description":"average cost per click, USD
calculated by dividing the cost of all clicks by the number of clicks","format":"double","type":["number","null"]},"clicks":{"description":"ad clicks
the number of clicks that the keyword and match type generated during the last month","type":["integer","null"]},"ctr":{"description":"click-through rate as a percentage
calculated by dividing the number of clicks by the number of impressions and multiplying the result by 100","format":"double","type":["number","null"]},"impressions":{"description":"ad impressions
the number of impressions that the keyword and match type generated during the last month","type":["integer","null"]},"total_cost":{"description":"total cost of an ad, USD
the cost of using the specified keyword and match type during the last month","format":"int64","type":["number","null"]}},"type":"object"},"Response0A3E90081762_KeywordProperties":{"properties":{"core_keyword":{"description":"main keyword in a group
contains the main keyword in a group determined by the synonym clustering algorithm
if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword","type":["string","null"]},"detected_language":{"description":"detected language of the keyword
indicates the language of the keyword as identified by our system","type":["string","null"]},"is_another_language":{"description":"detected language of the keyword is different from the set language
if true, the language set in the request does not match the language determined by our system for a given keyword","type":["boolean","null"]},"keyword_difficulty":{"description":"difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;
learn more about the metric in this help center guide","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"synonym_clustering_algorithm":{"description":"the algorithm used to identify synonyms
possible values:keyword_metrics - indicates the algorithm based on keyword_info parameterstext_processing - indicates the text-based algorithm
if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword","type":["string","null"]},"words_count":{"description":"number of words in the keyword
indicates how many words the keyword consists of","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationIndustriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationIndustriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationIndustriesResultInfo":{"properties":{"industry_id":{"description":"ID of the industry","format":"int64","type":["integer","null"]},"industry_name":{"description":"name of the industry","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationIndustriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationIndustriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationJobFunctionsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationJobFunctionsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationJobFunctionsResultInfo":{"properties":{"job_function_id":{"description":"ID of the job function","format":"int64","type":["integer","null"]},"job_function_name":{"description":"name of the job function","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationJobFunctionsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationJobFunctionsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationLiveResultInfo":{"properties":{"currency":{"description":"currency nameUSDollar","type":["string","null"]},"est_audience_size":{"description":"monthly estimated reach user count range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_clicks":{"description":"monthly estimated click count range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_cost_per_event":{"description":"indicates the estimated cost per event with range result","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_ctr":{"description":"estimated click-through rate range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_impressions":{"description":"monthly estimated impressions range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_reach_audience_size":{"description":"monthly estimated user count","format":"int64","type":["integer","null"]},"est_reach_impressions":{"description":"monthly estimated impressions","format":"int64","type":["integer","null"]},"est_spend":{"description":"monthly estimated spending range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"events_lost_to_bid":{"description":"indicates event lost count due to insufficient input bid","format":"int64","type":["integer","null"]},"events_lost_to_budget":{"description":"indicates the event lost count due to insufficient input budget","type":["integer","null"]},"suggested_bid":{"description":"suggested bid value under the current targeting","type":["number","null"]},"suggested_budget":{"description":"suggested daily budget value under the current targeting and bid","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskGetResultInfo":{"properties":{"currency":{"description":"currency nameUSDollar","type":["string","null"]},"est_audience_size":{"description":"monthly estimated reach user count range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_clicks":{"description":"monthly estimated click count range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_cost_per_event":{"description":"indicates the estimated cost per event with range result","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_ctr":{"description":"estimated click-through rate range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_impressions":{"description":"monthly estimated impressions range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"est_reach_audience_size":{"description":"monthly estimated user count","format":"int64","type":["integer","null"]},"est_reach_impressions":{"description":"monthly estimated impressions","format":"int64","type":["integer","null"]},"est_spend":{"description":"monthly estimated spending range","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AudienceEstimationInfo"}],"type":["object","null"]},"events_lost_to_bid":{"description":"indicates event lost count due to insufficient input bid","format":"int64","type":["integer","null"]},"events_lost_to_budget":{"description":"indicates the event lost count due to insufficient input budget","type":["integer","null"]},"suggested_bid":{"description":"suggested bid value under the current targeting","type":["number","null"]},"suggested_budget":{"description":"suggested daily budget value under the current targeting and bid","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint":{"description":"URL for collecting the results of the task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"type":["string","null"]},"tag":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingAudienceEstimationTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingAudienceEstimationTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceLiveResultInfo":{"properties":{"keyword":{"description":"keyword in a POST array","type":["string","null"]},"keyword_kpi":{"description":"object containing keyword metrics
if there is no data, then the value is_nulln","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordKpi"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"month":{"description":"indicates the month for which the data is provided for
example:10","type":["integer","null"]},"year":{"description":"indicates the year for which the data is provided for
example:2020","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceLocationsAndLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceLocationsAndLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceLocationsAndLanguagesResultInfo":{"properties":{"available_locations":{"description":"supported locations
contains locations supported in combination with a specific language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvailableLocations"}],"type":["object","null"]},"type":["array","null"]},"language_code":{"description":"language code","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceLocationsAndLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceLocationsAndLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskGetResultInfo":{"properties":{"keyword":{"description":"keyword in a POST array","type":["string","null"]},"keyword_kpi":{"description":"object containing keyword metrics
if there is no data, then the value is_nulln","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordKpi"}],"type":["object","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"month":{"type":["integer","null"]},"year":{"description":"indicates the year for which the data is provided for
example:2020monthn","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordPerformanceTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsLiveResultInfo":{"properties":{"categories":{"description":"product and service categories
legacy field, the value will always be null","items":{"type":["string","null"]},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only. This value is based on Bing Ads data.
Possible values: 0.1, 0.5,0.90.1 - low competition,0.5 - medium competition,0.9 - high competition;
if there is no data the value is null","type":["number","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword.
if there is no data, then the value is_nulln","type":["number","null"]},"device":{"description":"device type
indicates for what device type the data is provided;
possible values: all, mobile, desktop, tablet","type":["string","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword (as available for the past twelve months), targeted to the specified geographic locations.
if there is no data, then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks is included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the keyword on the Bing search engine, depending on the user’s targetingsearch volume is rounded to the closest decimal valuesnulln","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskGetResultInfo":{"properties":{"categories":{"description":"product and service categories
legacy field, the value will always be null","items":{"type":["string","null"]},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only. This value is based on Bing Ads data.
Possible values: 0.1, 0.5,0.9 0.1 - low competition,0.5 - medium competition, 0.9 - high competition;
if there is no data the value is null","type":["number","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword.
if there is no data, then the value is_nulln","type":["number","null"]},"device":{"description":"device type
indicates for what device type the data is provided;
possible values: all, mobile, desktop, tablet","type":["string","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"type":["string","null"]},"location_code":{"type":["integer","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword (as available for the past twelve months), targeted to the specified geographic locations.
if there is no data, then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the keyword on the Bing search engine, depending on the user’s targetingnulln","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForKeywordsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForSiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteLiveResultInfo":{"properties":{"categories":{"description":"product and service categories
legacy field, the value will always be null","items":{"type":["string","null"]},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only. This value is based on Bing Ads data.
Possible values: 0.1, 0.5,0.90.1 - low competition,0.5 - medium competition,0.9 - high competition;
if there is no data the value is null","type":["number","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword.
if there is no data, then the value is_nulln","type":["number","null"]},"device":{"description":"device type in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword (as available for the past twelve months), targeted to the specified geographic locations.
if there is no data, then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the keyword on the Bing search engine, depending on the user’s targetingsearch volume is rounded to the closest decimal valuesif there is no data, then the value is_nulln","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForSiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskGetResultInfo":{"properties":{"categories":{"description":"product and service categories
legacy field, the value will always be null","items":{"type":["string","null"]},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only. This value is based on Bing Ads data.
Possible values: 0.1, 0.5,0.9 0.1 - low competition,0.5 - medium competition, 0.9 - high competition;
if there is no data the value is null","type":["number","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword.
if there is no data the value is null","type":["number","null"]},"device":{"description":"device type in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data the value is null","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data the value is null","type":["integer","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locationsnull","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the given keyword idea on Bing search engine depending on the user’s targeting
if there is no data then the value is_nulln","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingKeywordsForSiteTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:\"location_code\": 9041134,where
\"location_name\": \"Vienna International Airport,Lower Austria,Austria\",
\"location_code_parent\": 20044location_code_parent corresponds to:\"location_code\": 20044,","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLiveResultInfo":{"properties":{"device":{"items":{"type":["string","null"]},"type":["array","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
\"location_name\": \"Lower Austria,Austria\"
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"period":{"description":"time period
indicates if returned data is aggregated to a certain time period
default value monthly","type":["string","null"]},"searches":{"description":"contains results distributed by device type
if the device parameter is not specified, the data will be returned for all available device types","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeHistorySearchInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLocationsAndLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLocationsAndLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLocationsAndLanguagesResultInfo":{"properties":{"available_locations":{"description":"array of available locations for a certain language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvailableLocations"}],"type":["object","null"]},"type":["array","null"]},"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLocationsAndLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryLocationsAndLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskGetResultInfo":{"properties":{"device":{"items":{"type":["string","null"]},"type":["array","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"period":{"type":["string","null"]},"searches":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeHistorySearchInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeHistoryTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeLiveResultInfo":{"properties":{"categories":{"description":"product and service categories
our API doesn't return categories for this endpoint: the parameter will always equal null","items":{"type":["string","null"]},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only. This value is based on Bing Ads data.
Possible values: 0.1, 0.5,0.90.1 - low competition,0.5 - medium competition,0.9 - high competition;
if there is no data the value is null","type":["number","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword.
if there is no data then the value is_nulln","type":["number","null"]},"device":{"description":"device type in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations
if there is no data then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents either the (approximate) number of searches for the given keyword idea on bing search engine depending on the user’s targeting;
search volume is rounded to the nearest tens;
if there is no data, the value is_nulln","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeTaskGetResultInfo":{"properties":{"categories":{"description":"product and service categories
our API doesn't return categories for this endpoint: the parameter will always equal null","items":{"type":["string","null"]},"type":["array","null"]},"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only. This value is based on Bing Ads data.
Possible values: 0.1, 0.5,0.9 0.1 - low competition,0.5 - medium competition, 0.9 - high competition;
if there is no data the value is null","type":["number","null"]},"cpc":{"description":"cost-per-click
represents the average cost per click (USD) historically paid for the keyword.
if there is no data then the value is_nulln","type":["number","null"]},"device":{"description":"device type in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations
if there is no data then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
search volume is rounded to the nearest tens","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataBingSearchVolumeTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataBingSearchVolumeTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataBulkSearchVolumeLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataSearchVolumeLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataBulkSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResultInfo":{"properties":{"items":{"description":"array of keywords
contains keywords and their search volume rates","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataSearchVolumeLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"ithe number of results returned in the items array","type":["integer","null"]},"language_code":{"description":"language code in a POST array
Note:if the keyword in the POST array appears to be misspelled, data will be returned for the correctly spelled keyword;
we use the functionality of Google Ads API to check and validate the spelling of keywords, learn more by this link","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is null","type":["integer","null"]},"use_clickstream":{"description":"indicates if the use_clickstream parameter is active
possible values: true, false","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveItem":{"properties":{"country_distribution":{"description":"distribution of clickstream by countries
represents clickstream-based search volume in available countries, as well as its respective percentage of global search volume","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CountryDistribution"}],"type":["object","null"]},"type":["array","null"]},"keyword":{"description":"keyword
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"search_volume":{"description":"clickstream-based average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea based on clickstream
you can learn more about clickstream search volume in this Help Center article","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveResultInfo":{"properties":{"items":{"description":"contains keywords and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataGlobalSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataLocationsAndLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataLocationsAndLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataLocationsAndLanguagesResultInfo":{"properties":{"available_languages":{"description":"supported languages
contains the languages which are supported for a specific location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvailableLanguages"}],"type":["object","null"]},"type":["array","null"]},"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
the value will be null as Country is the only supported location_type for this API","type":["string","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
possible values:Country","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataLocationsAndLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataClickstreamDataLocationsAndLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataClickstreamDataSearchVolumeLiveItem":{"properties":{"keyword":{"description":"keyword provided in the POST array","type":["string","null"]},"monthly_searches":{"description":"monthly search volume rates
array of objects with search volume rates in a certain month of a year","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_volume":{"description":"current search volume rate of a keyword","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsDemographyLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsDemographyLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsDemographyLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"contains keyword popularity and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsDemographyElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsDemographyLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsDemographyLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsExploreLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsExploreLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsExploreLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"contains keyword popularity and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsDataforseoTrendsGraphElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsExploreLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsExploreLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"geo_id":{"description":"DataForSEO trends location identifier
you can use this field for matching obtained results with the location_code parameter specified in the request","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:\"location_code\": 9041134,
\"location_name\": \"Vienna International Airport,Lower Austria,Austria\",
\"location_code_parent\": 20044
where location_code_parent corresponds to:\"location_code\": 20044,","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
\"location_name\": \"Lower Austria,Austria\"
possible values according to Google’s target types","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsMergedDataLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsMergedDataLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsMergedDataLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"contains keyword popularity and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataDataforseoTrendsItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsMergedDataLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsMergedDataLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsSubregionInterestsLiveResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"contains keyword popularity and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DataforseoTrendsSubregionInterestsElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataDataforseoTrendsSubregionInterestsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsLiveResultInfo":{"properties":{"average_cpc":{"description":"the average cost-per-click value
represents the cost-per-click (USD) estimated for a keyword based on the specified time period and historical data;
if there is no data, then the value is_nulln","format":"double","type":["number","null"]},"bid":{"description":"the maximum custom bid
the bid you have specified when setting the task
represents the price you are willing to pay for an ad
the higher value you have specified, the higher metrics and cost you receive in response
learn more in this help center article","format":"int64","type":["number","null"]},"clicks":{"description":"number of clicks on an ad
number of clicks an ad is projected to get within the specified time period
if there is no data, then the value is_nulln","type":["number","null"]},"cost":{"description":"total tasks cost, USD","type":["number","null"]},"ctr":{"description":"projected click through rate (CTR) of the advertisement
number of clicks an ad is projected to receive divided by the number of ad impressions; the CTR is projected for the specified time period
Note: parameter deprecated, the value is always null","format":"double","type":["number","null"]},"date_interval":{"description":"forecasting date interval in a POST array","type":["string","null"]},"impressions":{"description":"projected number of ad impressions
number of impressions an ad is projected to get within the specified time period
Note: parameter deprecated, the value is always null","type":["integer","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"match":{"description":"keywords match-type
can take the following values: exact, broad, phrase","type":["string","null"]},"search_partners":{"description":"include Google search partners
the value you specified when setting the task
Note: parameter deprecated, the value is always false","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResultInfo":{"properties":{"average_cpc":{"description":"the average cost-per-click value
represents the cost-per-click (USD) estimated for a keyword based on the specified time period and historical data;
if there is no data, then the value is_nulln","format":"double","type":["number","null"]},"bid":{"description":"the maximum custom bid
the bid you have specified when setting the task
represents the price you are willing to pay for an ad
the higher value you have specified, the higher metrics and cost you receive in response
learn more in this help center article","type":["number","null"]},"clicks":{"description":"number of clicks on an ad
number of clicks an ad is projected to get within the specified time period
if there is no data, then the value is_nulln","type":["number","null"]},"cost":{"description":"charge for an ad
amount that will be charged for running an ad within the specified time period
if there is no data, then the value is_nulln","type":["number","null"]},"ctr":{"description":"projected clickthrough rate (CTR) of the advertisement
number of clicks an ad is projected to receive divided by the number of ad impressions;
Note: parameter deprecated, the value is always null","format":"double","type":["number","null"]},"date_interval":{"description":"forecasting date interval in a POST array","type":["string","null"]},"impressions":{"description":"projected number of ad impressions
number of impressions an ad is projected to get within the specified time period
Note: parameter deprecated, the value is always_nulln","type":["integer","null"]},"keyword":{"description":"keyword in a POST array
metrics are provided for all the keywords specified in the POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"match":{"description":"keywords match-type
can take the following values: exact, broad, phrase","type":["string","null"]},"search_partners":{"description":"include Google search partners
the value is always false","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo":{"properties":{"competition":{"description":"competition
represents the relative level of competition associated with the given keyword in paid SERP only
possible values: LOW, MEDIUM, HIGH
if competition level is unknown, the value is null;
learn more about the metric in this help center article","type":["string","null"]},"competition_index":{"description":"competition index
the competition index for the query indicating how competitive ad placement is for the keyword
can take values from 0 to 100
the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available
if not enough data is available, the value is null;
learn more about the metric in this help center article","type":["integer","null"]},"cpc":{"description":"cost per click
indicates the amount paid (USD) for each click on the ad displayed for a given keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, the value is_nulln","type":["integer","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations
if there is no data, the value is null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"include Google search partners
the value you specified when setting the task
if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search;
if false, the results are returned for Google search sites only","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting
if there is no data, the value is null","format":"int64","type":["integer","null"]},"spell":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo":{"properties":{"competition":{"description":"competition
represents the relative level of competition associated with the given keyword in paid SERP only
possible values: LOW, MEDIUM, HIGH
if competition level is unknown, the value is null;
learn more about the metric in this help center article","type":["string","null"]},"competition_index":{"description":"competition index
the competition index for the query indicating how competitive ad placement is for the keyword
can take values from 0 to 100
the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available
if not enough data is available, the value is null;
learn more about the metric in this help center article","type":["integer","null"]},"cpc":{"description":"cost per click
indicates the amount paid (USD) for each click on the ad displayed for a given keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, the value is_nulln","type":["integer","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations
if there is no data, the value is null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"include Google search partners
the value you specified when setting the task
if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search;
if false, the results are returned for Google search sites only","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting
if there is no data, the value is null","format":"int64","type":["integer","null"]},"spell":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteLiveResultInfo":{"properties":{"competition":{"description":"competition
represents the relative level of competition associated with the given keyword in paid SERP only
possible values: LOW, MEDIUM, HIGH
if competition level is unknown, the value is null;
learn more about the metric in this help center article","type":["string","null"]},"competition_index":{"description":"competition index
the competition index for the query indicating how competitive ad placement is for the keyword
can take values from 0 to 100
the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available
if not enough data is available, the value is null;
learn more about the metric in this help center article","type":["integer","null"]},"cpc":{"description":"cost per click
indicates the amount paid (USD) for each click on the ad displayed for a given keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, the value is_nulln","type":["integer","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations
if there is no data, the value is null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"include Google search partners
the value you specified when setting the task
if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search;
if false, the results are returned for Google search sites only","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting
if there is no data, the value is null","format":"int64","type":["integer","null"]},"spell":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskGetResultInfo":{"properties":{"competition":{"description":"competition
represents the relative level of competition associated with the given keyword in paid SERP only
possible values: LOW, MEDIUM, HIGH
if competition level is unknown, the value is null;
learn more about the metric in this help center article","type":["string","null"]},"competition_index":{"description":"competition index
the competition index for the query indicating how competitive ad placement is for the keyword
can take values from 0 to 100
the level of competition from 0 to 100 is determined by the number of ad slots filled divided by the total number of ad slots available
if not enough data is available, the value is null;
learn more about the metric in this help center article","type":["integer","null"]},"cpc":{"description":"cost per click
indicates the amount paid (USD) for each click on the ad displayed for a given keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"keyword":{"description":"keyword in a POST array","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, the value is_nulln","type":["integer","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations
if there is no data, the value is null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"include Google search partners
the value you specified when setting the task
if true, the results are returned for owned, operated, and syndicated networks across Google and partner sites that host Google search;
if false, the results are returned for Google search sites only","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate
represents the (approximate) number of searches for the given keyword idea either on google.com or google.com and partners, depending on the user’s targeting
if there is no data, the value is null","format":"int64","type":["integer","null"]},"spell":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsKeywordsForSiteTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeLiveResultInfo":{"properties":{"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only;
this value is based on Google Ads data and can take the following values: HIGH, MEDIUM, LOW;
if there is no data the value is null;
learn more about the metric in this help center article","type":["string","null"]},"competition_index":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only;
this value is based on Google Ads data and can be between 0 and 100 (inclusive);
if there is no data the value is null;
learn more about the metric in this help center article","type":["integer","null"]},"cpc":{"description":"cost per click
indicates the amount paid (USD) for each click on the ad displayed for a given keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);
the value may differ depending on the location specified in a POST request","type":["number","null"]},"keyword":{"description":"keyword
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months by default), targeted to the specified geographic locations;
if there is no data then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate;
represents either the (approximate) number of searches for the given keyword idea on google.com or google.com and partners, depending on the user’s targeting;
if there is no data then the value is_nulln","format":"int64","type":["integer","null"]},"spell":{"description":"correct spelling of the keyword
Note:if the keyword in the POST array appears to be misspelled, data will be returned for the correctly spelled keyword;
we use the functionality of Google Ads API to check and validate the spelling of keywords, learn more by this link","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskGetResultInfo":{"properties":{"competition":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only;
this value is based on Google Ads data and can take the following values: HIGH, MEDIUM, LOW;
if there is no data the value is null;
learn more about the metric in this help center article","type":["string","null"]},"competition_index":{"description":"competition
represents the relative amount of competition associated with the given keyword in paid SERP only;
this value is based on Google Ads data and can be between 0 and 100 (inclusive);
if there is no data the value is null;
learn more about the metric in this help center article","type":["integer","null"]},"cpc":{"description":"cost per click
indicates the amount paid (USD) for each click on the ad displayed for a given keyword","type":["number","null"]},"high_top_of_page_bid":{"description":"maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);
the value may differ depending on the location specified in a POST request","type":["number","null"]},"keyword":{"description":"keyword
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"low_top_of_page_bid":{"description":"minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);
the value may differ depending on the location specified in a POST request","type":["number","null"]},"monthly_searches":{"description":"monthly searches
represents the (approximate) number of searches on this keyword idea (as available for the past twelve months by default), targeted to the specified geographic locations;
if there is no data then the value is_nulln","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MonthlySearchesInfo"}],"type":["object","null"]},"type":["array","null"]},"search_partners":{"description":"indicates whether data from partner networks included in the response","type":["boolean","null"]},"search_volume":{"description":"monthly average search volume rate","format":"int64","type":["integer","null"]},"spell":{"description":"correct spelling of the keyword
Note:if the keyword in the POST array appears to be misspelled, data will be returned for the correctly spelled keyword;
we use the functionality of Google Ads API to check and validate the spelling of keywords, learn more by this link","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsSearchVolumeTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsStatusResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsStatusTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsStatusResultInfo":{"properties":{"actual_data":{"description":"indicates whether Google updated keyword data for the previous month
generally, Google updates keyword data in the middle of the month
if the value is true, Google currently provides up-to-date data for the previous month
if the value is false, we are not able to provide data for the previous month","type":["boolean","null"]},"date_update":{"description":"date of the latest update of Google Ads data
indicates the latest date when Google updated search volume, CPC, and other keyword metrics
example:2020-05-15","type":["string","null"]},"last_month_in_monthly_searches":{"description":"the latest month for which search volume data is available","type":["integer","null"]},"last_year_in_monthly_searches":{"description":"the latest year for which search volume data is available","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleAdsStatusTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleAdsStatusResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsCategoriesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsCategoriesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsCategoriesResultInfo":{"properties":{"category_code":{"description":"unique google trends category identifier","type":["integer","null"]},"category_code_parent":{"description":"the code of the superordinate category
example:\"category_code\": 1100,\"category_name\": \"Superhero Films\",\"category_code_parent\": 1097
where category_code_parent corresponds to: \"category_code\": 1097,\"category_name\": \"Action & Adventure Films\"","type":["integer","null"]},"category_name":{"description":"name of the google trends category","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsCategoriesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsCategoriesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsExploreLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreLiveResultInfo":{"properties":{"check_url":{"description":"direct URL to the Google Trends results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"items on the Google Trends page","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataGoogleTrendsItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsExploreLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskGetResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskGetTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskGetResultInfo":{"properties":{"check_url":{"description":"direct URL to the Google Trends results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"items on the Google Trends page","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseKeywordDataGoogleTrendsItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keywords":{"description":"keywords in a POST array","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code in a POST array
if there is no data, then the value is_nulln","type":["string","null"]},"location_code":{"description":"location code in a POST array
if there is no data, then the value is_nulln","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskGetTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskGetResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KeywordsDataGoogleTrendsExploreTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphAiOverviewItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"asynchronous_ai_overview":{"description":"indicates whether the element is loaded asynchronously
if true, the ai_overview element is loaded asynchronously;
if false, the ai_overview element is loaded from cache","type":["boolean","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphCarouselItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphDescriptionItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphExpandedElement":{"properties":{"domain":{"description":"domain where a link points","type":["string","null"]},"featured_title":{"description":"title of a given element","type":["string","null"]},"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"relevant URL ","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KnowledgeGraphExpandedItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"expanded_element":{"description":"expanded element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphExpandedElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphHotelsBookingElement":{"properties":{"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"website domain","type":["string","null"]},"is_paid":{"description":"indicates whether the element is an ad","type":["boolean","null"]},"price":{"description":"pricing details
contains the pricing details of the product or service featured in the result","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"source":{"description":"name of the source of the video","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"image source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KnowledgeGraphHotelsBookingItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"date_from":{"description":"starting date of stay
in the format \"year-month-date\"
example:
2019-11-15","type":["string","null"]},"date_to":{"description":"ending date of stay
in the format \"year-month-date\"
example:
2019-11-17","type":["string","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphHotelsBookingElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphImagesElement":{"properties":{"alt":{"description":"alt tag of the image","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":" relevant URL of the Ad element in SERP","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KnowledgeGraphImagesItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphImagesElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphLinkElementInfo":{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KnowledgeGraphListElement":{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"subtitle":{"description":"subtitle of the item","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"sitelink URL","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KnowledgeGraphListItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphPartItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphRowItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"card_id":{"description":"card id","type":["string","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews","type":["string","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},"type":["array","null"]},"logo_url":{"description":"URL of the logo from knowledge graph","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"subtitle":{"description":"subtitle of the item","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_KnowledgeGraphShoppingElement":{"properties":{"domain":{"description":"domain where a link points","type":["string","null"]},"marketplace":{"description":"merchant account provider
ecommerce site that hosts products or websites of individual sellers under the same merchant account
example:by Google","type":["string","null"]},"marketplace_url":{"description":"URL to the merchant account provider
ecommerce site that hosts products or websites of individual sellers under the same merchant account","type":["string","null"]},"price":{"description":"pricing details
contains the pricing details of the product or service featured in the result;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_KnowledgeGraphShoppingItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphShoppingElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_LastModified":{"properties":{"header":{"description":"date and time when the header was last modifiedin the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"example:2019-11-15 12:57:46 +00:00if there is no data, the value will be null","type":["string","null"]},"meta_tag":{"description":"date and time when the meta tag was last modifiedin the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"example:2019-11-15 12:57:46 +00:00if there is no data, the value will be null","type":["string","null"]},"sitemap":{"description":"date and time when the sitemap was last modifiedin the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"example:2019-11-15 12:57:46 +00:00if there is no data, the value will be null","type":["string","null"]}},"type":"object"},"Response0A3E90081762_LinkElement":{"properties":{"description":{"description":"description of the results element","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ListDataInfo":{"properties":{"rising":{"description":"emerging related topics
represents the list of related topics with the biggest increase in search frequency since the last time period","items":{"type":["object","null"]},"type":["array","null"]},"top":{"description":"the most popular related topics
represents the list of the most popular related topics","items":{"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_LlmMentionsAggregatedMetricsInfo":{"properties":{"brand_entities_category":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity categories that appear in search results related to LLM queries
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"brand_entities_title":{"description":"data on brand entities relevant to the target
array of objects containing data on brand entity titles that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"language":{"description":"language-based grouping
array of objects containing mention metrics segmented by content language","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"location":{"description":"location-based grouping
array of objects containing mention metrics segmented by geographical location","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"platform":{"description":"platform-based grouping
array of group elements containing mention metrics segmented by AI platform","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"search_results_domain":{"description":"found top search results domains relevant to the target
array of objects containing data on top domains that appear in search results related to LLM queries;
Note: available only for chat_gpt","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"sources_domain":{"description":"found top source domains relevant to the target
array of objects containing data on top domains that are cited as sources in LLM responses
learn more about the sources and how to retrieve LLM citation data at our Help Center","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsItemInfo"}],"type":["object","null"]},"type":["array","null"]},"total":{"description":"aggregated mentions metrics summary
contains overall aggregated LLM mention metrics across all found domains","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AggregatedMetricsInfoTotalInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_LlmMessageSectionInfo":{"properties":{"annotations":{"description":"array of references used to generate the response
equals null if the web_search parameter is not set to true
Note: annotations may return empty even when web_search is true, as the AI will attempt to retrieve web information but may not find relevant results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AnnotationInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"text of the reasoning chain section
text of the reasoning chain section summarizing the model's thought process","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_LocalBusinessDeliveryServiceInfo":{"properties":{"title":{"description":"title of the element\ndomain of the online food ordering system","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to place an order","type":["string","null"]}}},"Response0A3E90081762_LocalBusinessMenuLink":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseLocalBusinessLink"},{"properties":{"title":{"description":"title of the element\ndomain of the online menu system","type":["string","null"]},"url":{"description":"URL to view the menu","type":["string","null"]}}}]},"Response0A3E90081762_LocalBusinessOrderLink":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseLocalBusinessLink"},{"properties":{"delivery_services":{"description":"lists available delivery services","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocalBusinessDeliveryServiceInfo"}],"type":["object","null"]},"type":["array","null"]}}}]},"Response0A3E90081762_LocalBusinessReservationLink":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseLocalBusinessLink"},{"properties":{"title":{"description":"title of the element\ndomain of the reservation software","type":["string","null"]},"url":{"description":"URL to make a reservation","type":["string","null"]}}}]},"Response0A3E90081762_LocalJustificationInfo":{"properties":{"text":{"description":"text snippet of local justification","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_LocalPackSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"booking_url":{"description":"URL of the booking page","type":["string","null"]},"cid":{"description":"google-defined client id","type":["string","null"]},"description":{"description":"description of the link","type":["string","null"]},"domain":{"description":"domain of the website hosting the video","type":["string","null"]},"is_paid":{"description":"indicates whether the element is an ad","type":["boolean","null"]},"phone":{"description":"phone number","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_LocalServicesElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"profile_image_url":{"description":"URL of the image featured in the element","type":["string","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_LocalServicesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"domain":{"description":"domain of the website hosting the video","type":["string","null"]},"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocalServicesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_LocationChain":{"properties":{"card_id":{"description":"card identifier","type":["string","null"]},"cid":{"description":"client id
learn more about the identifier in this help center article","type":["string","null"]},"feature_id":{"description":"feature identifier
learn more about the identifier in this help center article","type":["string","null"]},"title":{"description":"title of the element in the location chain","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MapSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MapsSearch":{"properties":{"additional_categories":{"description":"additional business categories
additional Google My Business categories that describe the services provided by the business entity in more detail","items":{"type":"string"},"type":["array","null"]},"address":{"description":"address of the business entity","type":["string","null"]},"address_info":{"description":"object containing address components of the business entity","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AddressInfo"}],"type":["object","null"]},"category":{"description":"business category
Google My Business general category that best describes the services provided by the business entity","type":["string","null"]},"category_ids":{"description":"global category IDs
universal category IDs that do not change based on the selected country","items":{"type":"string"},"type":["array","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews
learn more about the identifier in this help center article","type":["string","null"]},"domain":{"description":"domain of the business entity","type":["string","null"]},"feature_id":{"description":"the unique identifier of the element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"hotel_rating":{"description":"hotel class rating
class ratings range between 1-5 stars, learn more
if there is no hotel class rating information, the value will be null","type":["string","null"]},"is_claimed":{"description":"shows whether the entity is verified by its owner on Google Maps","type":["boolean","null"]},"is_directory_item":{"description":"business establishment is a part of the directory
indicates whether the business establishment is a part of the directory;
if true, the item is a part of the larger directory of businesses with the same address (e.g., a mall or a business centre);
note: if the business establishment is a parent item in the directory, the value will be null","type":["boolean","null"]},"latitude":{"description":"latitude coordinate of the local establishments in google maps
example:\"latitude\": 51.584091","type":["number","null"]},"local_justifications":{"description":"Google local justifications
snippets of text that “justify” why the business is showing up for search query","items":{"type":"string"},"type":["array","null"]},"longitude":{"description":"longitude coordinate of the local establishment in google maps
example:\"longitude\": -0.31365919999999997","type":["number","null"]},"main_image":{"description":"URL of the main image featured in Google My Business profile","type":["string","null"]},"phone":{"description":"phone number of the business entity","type":["string","null"]},"place_id":{"description":"unique place identifier
place id of the local establishment featured in the element
learn more about the identifier in this help center article","type":["string","null"]},"price_level":{"description":"property price level
can take values: inexpensive, moderate, expensive, very_expensive
if there is no price level information, the value will be null","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the elements","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from the rank_group","type":["integer","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"rating_distribution":{"additionalProperties":{"format":"Int64","type":["integer","null"]},"description":"the distribution of ratings of the business entity\nthe object displays the number of 1-star to 5-star ratings, as reviewed by users","type":["object","null"]},"snippet":{"description":"additional information about the business entity","type":["string","null"]},"title":{"description":"directory title
can take the following values: At this place, Directory","type":["string","null"]},"total_photos":{"description":"total count of images featured in Google My Business profile","format":"int64","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to view the menu","type":["string","null"]},"work_hours":{"description":"open hours
information about work hours of the local establishment","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessWorkHoursInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_Markets":{"properties":{"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"market":{"description":"financial market identifier
possible values: US, Europe, Asia, Currencies, Crypto, Futures","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MathSolverElement":{"properties":{"expanded_element":{"description":"expanded element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MathSolverExpandedElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MathSolverExpandedElement":{"properties":{"solution":{"description":"solution of the element
displays steps to solve the mathematical equation as specified in the element","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the carousel item","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MathSolverSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MathSolverElement"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"result":{"description":"solution to the equation
solution to the mathematical equation specified in the keyword field when setting a task","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MentionCarouselElement":{"properties":{"mentioned_in":{"description":"additional elements in the mention_carousel item","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"price":{"description":"price of the app element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the element’s rating \nthe popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of the row","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MentionCarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MentionCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of a given link element","type":["string","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_MerchantAmazonAsinLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinLiveAdvancedResultInfo":{"properties":{"asin":{"description":"ASIN received in a POST array
the unique product identifier in Amazon (ASIN) received in a POST array
learn more about the identified in this help center guide","type":["string","null"]},"check_url":{"description":"direct URL to Amazon results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found on Amazon
contains types of all search results (items) found in the returned SERP
possible item types:amazon_product_info","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"Amazon product info items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonProductInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"Amazon domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonAsinLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinLiveHtmlResultInfo":{"properties":{"asin":{"description":"ASIN received in a POST array","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonAsinLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskGetAdvancedResultInfo":{"properties":{"asin":{"description":"ASIN received in a POST array
the unique product identifier in Amazon (ASIN) received in a POST array
learn more about the identified in this help center guide","type":["string","null"]},"check_url":{"description":"direct URL to Amazon results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found on Amazon
contains types of all search results (items) found in the returned SERP
possible item types:amazon_product_info","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"Amazon product info items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonProductInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"Amazon domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskGetHtmlResultInfo":{"properties":{"asin":{"description":"ASIN received in a POST array","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the Amazon ASIN Advanced task","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the Amazon ASIN HTML task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
can take the following values: shopping","type":["string","null"]},"tag":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonAsinTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonAsinTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_name_parent":{"description":"the name of the superordinate location
example:\"location_code\": 9041134,","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonPaidSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},{"properties":{"bought_past_month":{"description":"number of product purchases in the past month","type":["integer","null"]},"currency":{"description":"currency in the ISO format
\"location_name\": \"90290,California,United States\",
\"location_name_parent\": \"California,United States\"
example:USD","type":["string","null"]},"data_asin":{"description":"unique product identifier on Amazon
note that there is no full list of possible values as the data_asin is a dynamic value assigned by Amazon
example:B07G82D89J","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonDeliveryInfo"}],"type":["object","null"]},"domain":{"description":"Amazon domain","type":["string","null"]},"image_url":{"description":"URL of the product image featured in the results","type":["string","null"]},"is_amazon_choice":{"description":"\"Amazon's choice\" label
if the value is true, the product is marked with the \"Amazon's choice\" label","type":["boolean","null"]},"is_best_seller":{"description":"\"Best Seller\" label
if the value is true, the product is marked with the \"Best Seller\" label","type":["boolean","null"]},"labels":{"description":"product labels
array containing an object with main Amazon labels’ information
if the product contains no labels, the value will be null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"price_from":{"description":"the regular price of a product
example:49.98","type":["number","null"]},"price_to":{"description":"the upper limit of the product price range
example:384.99","type":["number","null"]},"rating":{"description":"product rating info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"special_offers":{"description":"special offer details
contains special offer details, including coupon and Subscribe & Save discounts","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"product title","type":["string","null"]},"url":{"description":"the URL of the product page","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsLiveAdvancedResultInfo":{"properties":{"categories":{"description":"amazon product departments and subcategories","type":["object","null"]},"check_url":{"description":"direct URL to Amazon results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in Amazon SERP
contains types of all search results (items) found in the returned SERP
possible item types:amazon_serp, amazon_paid, editorial_recommendations, top_rated_from_our_brands, related_searches","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"Amazon product items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"search engine results count","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonProductsLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonProductsLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskGetAdvancedResultInfo":{"properties":{"categories":{"description":"amazon product departments and subcategories","items":{"type":["string","null"]},"type":["array","null"]},"check_url":{"description":"direct URL to Amazon results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in Amazon SERP
contains types of all search results (items) found in the returned SERP
possible item types:amazon_serp, amazon_paid, editorial_recommendations, top_rated_from_our_brands, related_searches","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"Amazon product items within the editorial_recommendations element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"search engine results count","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"HTML pages and related data","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the Amazon Products Advanced task","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the Amazon Products HTML task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
can take the following values: organic","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonProductsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonProductsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellerItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonSellersElementItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellerMainItemSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonSellersElementItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersLiveAdvancedResultInfo":{"properties":{"asin":{"description":"asin received in a POST array
learn more about ASINs in this help center guide","type":["string","null"]},"check_url":{"description":"direct URL to Amazon results
you can use it to make sure the provided results are accurate","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"image":{"description":"product image url
image URL of the product relevant to the asin received in a POST array","type":["string","null"]},"item_types":{"description":"types of search results found in Amazon Sellers SERP
contains types of all search results (items) found in the returned SERP
possible item types:amazon_seller_main_item, amazon_seller_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonSellersElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code received in a POST array","type":["string","null"]},"location_code":{"description":"location code received in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain received in a POST array","type":["string","null"]},"title":{"description":"product title
title of the product relevant to the asin received in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonSellersLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersLiveHtmlResultInfo":{"properties":{"asin":{"description":"ASIN received in a POST array ","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found on Amazon","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonSellersLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskGetAdvancedResultInfo":{"properties":{"asin":{"description":"asin received in a POST array
learn more about ASINs in this help center guide","type":["string","null"]},"check_url":{"description":"direct URL to Amazon results
you can use it to make sure the provided results are accurate","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"image":{"description":"product image url
image URL of the product relevant to the asin received in a POST array","type":["string","null"]},"item_types":{"description":"types of search results found in Amazon Sellers SERP
contains types of all search results (items) found in the returned SERP
possible item types:amazon_seller_main_item, amazon_seller_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonSellersElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code received in a POST array","type":["string","null"]},"location_code":{"description":"location code received in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain received in a POST array","type":["string","null"]},"title":{"description":"product title
title of the product relevant to the asin received in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskGetHtmlResultInfo":{"properties":{"asin":{"description":"ASIN received in a POST array ","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found on Amazon","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of Amazon Sellers Advanced task","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of Amazon Sellers HTML task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantAmazonSellersTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantAmazonSellersTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantAmazonSerpSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},{"properties":{"bought_past_month":{"description":"number of product purchases in the past month","type":["integer","null"]},"currency":{"description":"currency in the ISO format
example:USD","type":["string","null"]},"data_asin":{"description":"unique product identifier on Amazon
note that there is no full list of possible values as the data_asin is a dynamic value assigned by Amazon
example:B07G82D89J","type":["string","null"]},"delivery_info":{"description":"delivery information
delivery information including free and fast delivery date ranges","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonDeliveryInfo"}],"type":["object","null"]},"domain":{"description":"Amazon domain","type":["string","null"]},"image_url":{"description":"URL of the product image featured in the results","type":["string","null"]},"is_amazon_choice":{"description":"\"Amazon's choice\" label
if the value is true, the product is marked with the \"Amazon's choice\" label","type":["boolean","null"]},"is_best_seller":{"description":"\"Best Seller\" label
if the value is true, the product is marked with the \"Best Seller\" label","type":["boolean","null"]},"labels":{"description":"product labels
array containing an object with main Amazon labels’ information
if the product contains no labels, the value will be null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"price_from":{"description":"the regular price of a product
example:49.98","type":["number","null"]},"price_to":{"description":"the upper limit of the product price range
example:384.99","type":["number","null"]},"rating":{"description":"product rating info","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"special_offers":{"description":"special offer details
contains special offer details, including coupon and Subscribe & Save discounts","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"product title","type":["string","null"]},"url":{"description":"the URL of the product page","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantEditorialRecommendationsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"Amazon product items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonSerpElement"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in Amazon SERP
possible values:left, right","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_name_parent":{"description":"the name of the superordinate location
example:
`\"location_name\": \"Arkansas,United States\"`,
`\"location_name_parent\": \"United States\"`","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of items found on the product specification page
possible item types:product_info_element","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items on the product page
contains all product attributes and related data listed on the product page","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ProductInfoElement"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"product_id":{"description":"product ID in a POST array
learn more about the parameter in this help center guide","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductInfoTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductInfoTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the Google Shopping Product Specifications Advanced task","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the Google Shopping Product Specifications HTML task
note: HTML is not available for this endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
can take the following values: shopping_specifications","type":["string","null"]},"tag":{"type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleProductInfoTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductInfoTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to Google Shopping results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in Google Shopping SERP
contains types of all search results (items) found in the returned SERP
possible item types:google_shopping_sponsored_carousel, google_shopping_paid, google_shopping_serp, google_shopping_carousel, related_searches","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"additional items present in the element
contains a list of related keywords;
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found on Google Shopping","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of Google Shopping Products Advanced task","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of Google Shopping Products HTML task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: products","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleProductsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleProductsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleSellersTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to Google Shopping results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"image_url":{"description":"URL to the product image","type":["string","null"]},"item_types":{"description":"types of search results found in Google Shopping SERP
contains types of all search results (items) found in the returned SERP
possible item types:shops_list, buy_on_google","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingSellersElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"product_id":{"description":"product_id received in a POST array
learn more about the parameter in this help center guide","type":["string","null"]},"rating":{"description":"product rating
the product popularity rate based on product reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"title":{"description":"title of the product","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the product page","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleSellersTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleSellersTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleSellersTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of Google Shopping Sellers Advanced task","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of Google Shopping Sellers HTML task","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
can take the following values: shopping","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MerchantGoogleSellersTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MerchantGoogleSellersTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantRelatedSearchesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"Amazon product items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedSearchesElement"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in Amazon SERP
possible values:left, right","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MerchantTopRatedFromOurBrandsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"Amazon product items","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonSerpElement"}],"type":["object","null"]},"type":["array","null"]},"position":{"description":"the alignment of the element in Amazon SERP
possible values:left, right","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MessageAiOptimizationLlmResponseElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},{"properties":{"sections":{"description":"reasoning chain sections
array of objects containing the reasoning chain sections generated by the LLM","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LlmMessageSectionInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_MessageInfo":{"properties":{"level":{"description":"level of error\ncan take the following values: fatal, error, warning, info","type":["string","null"]},"message":{"description":"message associated with an error\nmessage providing the details of the detected error","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MetricsBundleInfo":{"properties":{"organic":{"description":"ranking and traffic data from organic search","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MetricsInfo"}],"properties":{"is_down":{"description":"rank went down\nindicates how many ranked elements of this domain went down in Google Search","format":"int64","type":["integer","null"]},"is_lost":{"description":"lost ranked elements\nindicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check","format":"int64","type":["integer","null"]},"is_new":{"description":"number of new ranked elements\nindicates how many new ranked elements were found for this domain","format":"int64","type":["integer","null"]},"is_up":{"description":"rank went up\nindicates how many ranked elements of this domain went up in Google Search","format":"int64","type":["integer","null"]}},"type":["object","null"]},"paid":{"description":"ranking and traffic data from paid search","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MetricsInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_MetricsInfo":{"properties":{"count":{"description":"total count of organic SERPs that contain the domain","format":"int64","type":["integer","null"]},"estimated_paid_traffic_cost":{"description":"estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads (USD) for all keywords a domain ranks for
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
learn more about how the metric is calculated in this help center article","type":["number","null"]},"etv":{"description":"estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain ranks for
learn more about how the metric is calculated in this help center article","type":["number","null"]},"is_down":{"description":"rank went down\nindicates how many ranked elements of this domain went down in Google Search","format":"int64","type":["integer","null"]},"is_lost":{"description":"lost ranked elements\nindicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check","format":"int64","type":["integer","null"]},"is_new":{"description":"number of new ranked elements\nindicates how many new ranked elements were found for this domain","format":"int64","type":["integer","null"]},"is_up":{"description":"rank went up\nindicates how many ranked elements of this domain went up in Google Search","format":"int64","type":["integer","null"]},"pos_1":{"description":"number of organic SERPs where the domain ranks #1","type":["integer","null"]},"pos_11_20":{"description":"number of organic SERPs where the domain ranks #11-20","type":["integer","null"]},"pos_21_30":{"description":"number of organic SERPs where the domain ranks #21-30","type":["integer","null"]},"pos_2_3":{"description":"number of organic SERPs where the domain ranks #2-3","type":["integer","null"]},"pos_31_40":{"description":"number of organic SERPs where the domain ranks #31-40","type":["integer","null"]},"pos_41_50":{"description":"number of organic SERPs where the domain ranks #41-50","type":["integer","null"]},"pos_4_10":{"description":"number of organic SERPs where the domain ranks #4-10","type":["integer","null"]},"pos_51_60":{"description":"number of organic SERPs where the domain ranks #51-60","type":["integer","null"]},"pos_61_70":{"description":"number of organic SERPs where the domain ranks #61-70","type":["integer","null"]},"pos_71_80":{"description":"number of organic SERPs where the domain ranks #71-80","type":["integer","null"]},"pos_81_90":{"description":"number of organic SERPs where the domain ranks #81-90","type":["integer","null"]},"pos_91_100":{"description":"number of organic SERPs where the domain ranks #91-100","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_MicrodataFieldsInfo":{"properties":{"fields":{"description":"microdata fields
an array of objects containing data fields related to the certain microdata type","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MicrodataFieldsInfo"}],"type":["object","null"]},"type":["array","null"]},"name":{"description":"field name
name of the data field","type":["string","null"]},"test_results":{"description":"microdata validation test results
sub-type microdata test results that contain detected errors and related messages","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MessageInfo"}],"type":["object","null"]},"types":{"description":"list of microdata types","items":{"type":["string","null"]},"type":["array","null"]},"value":{"description":"microdata value\nmicrodata value specified on a target web page","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MicrodataInspectionInfo":{"properties":{"fields":{"description":"microdata fields
an array of objects containing data fields related to the certain microdata type","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MicrodataFieldsInfo"}],"type":["object","null"]},"type":["array","null"]},"types":{"description":"parent microdata types
for a full list of available types, please visit schema.org","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_MonthlySearchesInfo":{"properties":{"month":{"description":"month","type":["integer","null"]},"search_volume":{"description":"monthly average search volume rate","type":["integer","null"]},"year":{"description":"year","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_MultiCarouselElement":{"properties":{"multi_carousel_snippets":{"description":"multi_carousel_snippet results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpApiCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_MultiCarouselSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MultiCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_NewerModel":{"properties":{"newer_model_asin":{"description":"ASIN of the newer product model","type":["string","null"]},"title":{"description":"product title","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageAlternateLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"properties":{"hreflang":{"description":"hreflang attribute value
language and optional country code specified in the hreflang attribute
example: \"en-US\", \"fr\"","type":["string","null"]},"is_valid_hreflang":{"description":"hreflang validity status
indicates whether the hreflang attribute is correctly implemented","type":["boolean","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageAnchorLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"properties":{"link_attribute":{"description":"link attribute added to external link
indicates link attributes added to the link_to on the page_from
example:[\"ugc\",\"noopener\"]","items":{"type":["string","null"]},"type":["array","null"]},"text":{"description":"anchor text","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageAvailableFiltersResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageAvailableFiltersTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageAvailableFiltersResultInfo":{"properties":{"keyword_density":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"links":{"additionalProperties":{"description":"type of element","type":["string","null"]},"type":["object","null"]},"non_indexable":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"pages":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"pages_by_resource":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"redirect_chains":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"resources":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]},"uncrawlable_resources":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_OnPageAvailableFiltersTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
contains the full list of available parameters that can be used for data filtration
the parameters are grouped by the endpoint they can be used with","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageAvailableFiltersResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageBrokenResourceItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},{"properties":{"accept_type":{"description":"indicates the expected type of resource
for example, if \"resource_type\": \"broken\", accept_type will indicate the type of the broken resource
possible values: any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font","type":["string","null"]},"fetch_timing":{"description":"time range within which a result was fetched","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FetchTiming"}],"type":["object","null"]},"is_resource":{"description":"indicates whether a page is a single resource","type":["boolean","null"]},"meta":{"description":"resource properties
the value depends on the resource_type
note that if you do not indicate a url when setting a task, resource's meta is returned based on the data from the page where our crawler first saw the resource;
to obtain resource's meta from a particular url, specify that URL when setting a task","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageMetaInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageCanonicalLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageContentParsingLiveResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageContentParsingLiveTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageContentParsingLiveResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentParsingElement"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageContentParsingLiveTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageContentParsingLiveResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageContentParsingResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageContentParsingTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageContentParsingResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentParsingElement"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array
","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageContentParsingTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageContentParsingResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageDuplicateContentItem":{"properties":{"pages":{"description":"pages with duplicate content","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DuplicatePageInfo"}],"type":["object","null"]},"type":["array","null"]},"total_count":{"description":"total count of duplicate pages","format":"int64","type":["integer","null"]},"url":{"description":"URL of the specified page","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageDuplicateContentResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageDuplicateContentTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageDuplicateContentResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageDuplicateContentItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageDuplicateContentTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageDuplicateContentResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageDuplicateTagsItem":{"properties":{"accumulator":{"description":"contains the value of duplicated tag","type":["string","null"]},"pages":{"description":"pages with duplicate tags","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageHtmlResourceItem"}],"type":["object","null"]},"type":["array","null"]},"total_count":{"description":"total count of duplicate pages","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageDuplicateTagsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageDuplicateTagsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageDuplicateTagsResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageDuplicateTagsItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"pages_count":{"description":"number of pages with duplicate tags in the response
displays the number of pages with duplicate tags returned in the response","format":"int64","type":["integer","null"]},"total_pages_count":{"description":"total number of pages with duplicate tags
displays the total number of pages with duplicate tags of the target website","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageDuplicateTagsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageDuplicateTagsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageForceStopResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageForceStopTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageForceStopTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageHtmlResourceItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},{"properties":{"broken_links":{"description":"indicates whether a page contains broken links","type":["boolean","null"]},"broken_resources":{"description":"indicates whether a page contains broken resources","type":["boolean","null"]},"click_depth":{"description":"number of clicks it takes to get to the pageindicates the number of clicks from the homepage needed before landing at the target page","type":["integer","null"]},"custom_js_client_exception":{"description":"error when executing a custom jsif the error occurred when executing the script you specified in the custom_js field, the error message would be displayed here","type":["string","null"]},"custom_js_response":{"description":"the result of executing a specified JS scriptnote that you should specify a custom_js field when setting a task to receive this data and the field type and its value will totally depend on the script you specified;you can also filter the results by this value specifying filters in the following way:[\"custom_js_response.url\", \"like\", \"pixel\"]","type":["object","null"]},"duplicate_content":{"description":"indicates whether a page has duplicate content","type":["boolean","null"]},"duplicate_description":{"description":"indicates whether a page has a duplicate description","type":["boolean","null"]},"duplicate_title":{"description":"indicates whether a page has duplicate title tags","type":["boolean","null"]},"is_resource":{"description":"indicates whether a page is a single resource","type":["boolean","null"]},"meta":{"description":"page propertiesthe value depends on the resource_type","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageMetaInfo"}],"properties":{"broken_html":{"description":"resource errors and warnings","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourceIssueInfo"}],"type":["object","null"]},"social_media_tags":{"additionalProperties":{"type":["string","null"]},"type":["object","null"]}},"type":["object","null"]},"onpage_score":{"description":"shows how page is optimized on a 100-point scalethis field shows how page is optimized considering critical on-page issues and warnings detected;100 is the highest possible score that means the page does not have any critical on-page issues and important warnings;learn more about how the metric is calculated in this help center article","type":["number","null"]},"page_timing":{"description":"object of page load metrics","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageTiming"}],"type":["object","null"]},"relative_url_length":{"description":"relative URL length in characters","type":["integer","null"]},"total_dom_size":{"description":"total DOM size of a page","format":"int64","type":["integer","null"]},"url_length":{"description":"page URL length in characters","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageImageLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"properties":{"image_alt":{"description":"alternative text for the image","type":["string","null"]},"image_src":{"description":"url of the image","type":["string","null"]},"link_attribute":{"description":"link attribute added to external link
indicates link attributes added to the link_to on the page_from
example:[\"ugc\",\"noopener\"]","items":{"type":["string","null"]},"type":["array","null"]},"text":{"description":"anchor text","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageImageResourceItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},{"properties":{"accept_type":{"description":"indicates the expected type of resourcefor example, if \"resource_type\": \"broken\", accept_type will indicate the type of the broken resourcepossible values:any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font","type":["string","null"]},"fetch_timing":{"description":"time range within which a result was fetched","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FetchTiming"}],"type":["object","null"]},"meta":{"description":"page propertiesthe value depends on the resource_type","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ResourceMetaInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageInstantPagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageInstantPagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageInstantPagesResultInfo":{"properties":{"crawl_gateway_address":{"description":"crawler ip addressdisplays the IP address used by the crawler to initiate the current crawling sessionyou can find the full list of IPs used by our crawler in the Overview section","type":["string","null"]},"crawl_progress":{"description":"status of the crawling sessionpossible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling sessionin this case the value will be null","type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageHtmlResourceItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageInstantPagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageInstantPagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageKeywordDensityItem":{"properties":{"density":{"description":"keyword density
calculated as a ratio of frequency to the total count of keywords with the set keyword_length on the web page or website","type":["number","null"]},"frequency":{"description":"keyword frequency
number of times the keyword appears on the website (or webpage if you specified a url)","type":["integer","null"]},"keyword":{"description":"returned keyword","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageKeywordDensityResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageKeywordDensityTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageKeywordDensityResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageKeywordDensityItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"total_items_count":{"description":"total number of relevant items
total number of keywords on the specified website or web page matching the set keyword_length and filters","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageKeywordDensityTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageKeywordDensityResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseAuditsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseAuditsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseAuditsResultInfo":{"properties":{"audits":{"description":"the list of available lighthouse audits
an array containing the titles of available audits;
Note: the titles can change depending on if the audit passed or failed and may contain markdown code;
Note #2: if you're using the audit that contains a slash (/) in its name, search by the last word after the slash","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_OnPageLighthouseAuditsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseAuditsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageLighthouseLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseLiveJsonResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseLiveJsonTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseLiveJsonTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"results of Lighthouse audit
this array will include data according to the parameters you specified when setting a task;
unique task identifier in our system in the UUID format","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageLighthouseTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseVersionsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseVersionsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLighthouseVersionsResultInfo":{"properties":{"availible_versions":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AvailibleVersions"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_OnPageLighthouseVersionsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLighthouseVersionsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLinkLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLinksResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLinksTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageLinksResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"current_offset":{"type":["integer","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"search_after_token":{"type":["string","null"]},"total_items_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageLinksTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageLinksResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageMetaLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageMicrodataInfoItem":{"properties":{"inspection_info":{"description":"information related to microdata validation","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_MicrodataInspectionInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageMicrodataResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageMicrodataTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageMicrodataResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageMicrodataInfoItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"test_summary":{"description":"microdata validation test results","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TestSummary"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_OnPageMicrodataTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageMicrodataResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageNonIndexableItem":{"properties":{"reason":{"description":"the reason why the page is non-indexable
can take the following values: robots_txt, meta_tag, http_header, attribute, too_many_redirects","type":["string","null"]},"url":{"description":"url of the non-indexable page","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageNonIndexableResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageNonIndexableTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageNonIndexableResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageNonIndexableItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"total_items_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageNonIndexableTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageNonIndexableResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPagePageScreenshotResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPagePageScreenshotTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPagePageScreenshotResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"error_message":{"description":"error message
if the url you indicated returns a 404 status code or is not a valid URL, you will obtain \"error_message\":\"Screenshot is empty\"
if no error is encountered, the value will be null","type":["string","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ScreenshotItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPagePageScreenshotTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPagePageScreenshotResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPagePagesByResourceResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPagePagesByResourceTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPagePagesByResourceResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageHtmlResourceItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"total_items_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPagePagesByResourceTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPagePagesByResourceResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPagePagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPagePagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPagePagesResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling sessionpossible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"current_offset":{"type":["integer","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"search_after_token":{"type":["string","null"]},"total_items_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPagePagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPagePagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageRawHtmlItem":{"properties":{"html":{"description":"HTML_pagen","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageRawHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRawHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageRawHtmlResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items object","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRawHtmlItem"}],"type":["object","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageRawHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRawHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageRedirectChainsItem":{"properties":{"chain":{"description":"contains links that form a chain","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRedirectLinkItem"}],"type":["object","null"]},"type":["array","null"]},"is_redirect_loop":{"description":"indicates if redirects in chain start and end at the same URL
if true, the last URL from the chain redirects back to the original URL","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_OnPageRedirectChainsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRedirectChainsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageRedirectChainsResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRedirectChainsItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"total_items_count":{"description":"total number of relevant items in the database","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageRedirectChainsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageRedirectChainsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageRedirectLinkItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageLinkItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageRedirectResourceItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},{"properties":{"fetch_timing":{"description":"time range within which a result was fetched","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FetchTiming"}],"type":["object","null"]},"is_resource":{"description":"indicates whether a page is a single resource","type":["boolean","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageResourceIssueInfo":{"description":"resource errors and warnings","properties":{"errors":{"description":"resource errors","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourceIssueItemInfo"}],"type":["object","null"]},"type":["array","null"]},"warnings":{"description":"resource warnings","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourceIssueItemInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_OnPageResourceIssueItemInfo":{"properties":{"column":{"description":"column where the error was found","type":["integer","null"]},"line":{"description":"line where the error was found","type":["integer","null"]},"message":{"description":"text message of the errorthe full list of possible HTML errors can be found here","type":["string","null"]},"status_code":{"description":"general status codeyou can find the full list of the response codes hereNote: we strongly recommend designing a necessary system for handling related exceptional or error conditions","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageResourceLocationInfo":{"properties":{"line":{"description":"line number
the number of the line on which the resource is located","type":["integer","null"]},"offset_left":{"description":"position in line
the number of line characters before the resource;
sometimes referred to as column
Note: counts from 1, i.e. if the resource doesn't have any characters to the left, the value will be 1","type":["integer","null"]},"offset_top":{"description":"position in the document
the total number of characters between the resource and the top of HTML","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageResourcesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourcesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageResourcesResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"current_offset":{"type":["integer","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]},"search_after_token":{"type":["string","null"]},"total_items_count":{"description":"total number of relevant items crawled","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageResourcesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourcesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageScriptResourceItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},{"properties":{"accept_type":{"description":"indicates the expected type of resourcefor example, if \"resource_type\": \"broken\", accept_type will indicate the type of the broken resourcepossible values:any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font","type":["string","null"]},"fetch_timing":{"description":"time range within which a result was fetched","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FetchTiming"}],"type":["object","null"]},"meta":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ResourceMetaInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageStylesheetResourceItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseOnPageResourceItem"}],"type":["object","null"]},{"properties":{"accept_type":{"description":"indicates the expected type of resourcefor example, if \"resource_type\": \"broken\", accept_type will indicate the type of the broken resourcepossible values:any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font","type":["string","null"]},"fetch_timing":{"description":"time range within which a result was fetched","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FetchTiming"}],"type":["object","null"]},"meta":{"description":"page propertiesthe value depends on the resource_type","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ResourceMetaInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageSummaryResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageSummaryTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageSummaryResultInfo":{"properties":{"crawl_gateway_address":{"description":"crawler ip address
displays the IP address used by the crawler to initiate the current crawling session
you can find the full list of IPs used by our crawler in the Overview section","type":["string","null"]},"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"crawl_stop_reason":{"description":"reason why the crawling stopped
information about the reason why the crawling process stopped;
possible values:limit_exceeded - the limit set in the max_crawl_pages was exceeded;empty_queue - all URLs in the queue were crawled;force_stopped - the crawling process was halted using the On Page API Force Stop function;unexpected_exception - an internal error was encountered while crawling the target, contact support for more info","type":["string","null"]},"domain_info":{"description":"domain-wide info
on-page information about the target domain and crawling process","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DomainInfo"}],"type":["object","null"]},"page_metrics":{"description":"page-specific info
metrics information on the target website pages","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageMetrics"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_OnPageSummaryTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageSummaryResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]},"target":{"description":"target website specified when setting a task","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageUncrawlableResourcesItem":{"properties":{"fetch_time":{"description":"date and time when the resource was fetched
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2026-03-09 18:20:32 +00:00","type":["string","null"]},"meta":{"description":"metadata of the uncrawlable resource","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_UncrawlableResourcesMeta"}],"type":["object","null"]},"reason":{"description":"reason the resource is uncrawlable
can take the following values: content_type_inconsistency","type":["string","null"]},"status_code":{"description":"general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions","type":["integer","null"]},"url":{"description":"URL of the uncrawlable resource","type":["string","null"]}},"type":"object"},"Response0A3E90081762_OnPageUncrawlableResourcesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageUncrawlableResourcesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageUncrawlableResourcesResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"current_offset":{"type":["integer","null"]},"items":{"description":"array of uncrawlable resources","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageUncrawlableResourcesItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of uncrawlable resources in the items array","format":"int64","type":["integer","null"]},"total_items_count":{"description":"total number of uncrawlable resources found
total number of uncrawlable resources found during the crawl of the target domain","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageUncrawlableResourcesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageUncrawlableResourcesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageWaterfallItem":{"properties":{"connection_time":{"description":"time to connect to a server
the time it takes until the connection with a server is established (in milliseconds)","type":["integer","null"]},"dom_complete":{"description":"time to load resources
the time it takes until the page and all of its subresources are downloaded (in milliseconds)","type":["integer","null"]},"download_time":{"description":"time it takes for a browser to receive a response (in milliseconds)","type":["integer","null"]},"duration_time":{"description":"total time it takes until a browser receives a complete response from a server (in milliseconds)","type":["integer","null"]},"fetch_end":{"description":"time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page","type":["integer","null"]},"fetch_start":{"description":"time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page","type":["integer","null"]},"page_url":{"description":"URL of the page","type":["string","null"]},"request_sent_time":{"description":"time to send a request to a server
the time it takes until the request to a server is sent (in milliseconds)","type":["integer","null"]},"resources":{"description":"resource-specific timing
contains separate arrays with timing for each resource found on the page","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_WaterfallResourceInfo"}],"type":["object","null"]},"type":["array","null"]},"time_to_interactive":{"description":"Time To Interactive (TTI) metric
the time it takes until the user can interact with a page (in milliseconds)","type":["integer","null"]},"time_to_secure_connection":{"description":"time to establish a secure connection
the time it takes until the secure connection with a server is established (in milliseconds)","type":["integer","null"]},"waiting_time":{"description":"time to first byte (TTFB) in milliseconds","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageWaterfallResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageWaterfallTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OnPageWaterfallResultInfo":{"properties":{"crawl_progress":{"description":"status of the crawling session
possible values: in_progress, finished","type":["string","null"]},"crawl_status":{"description":"details of the crawling session","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_CrawlStatusInfo"}],"type":["object","null"]},"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageWaterfallItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_OnPageWaterfallTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageWaterfallResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OrganicSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"about_this_result":{"deprecated":true,"description":"contains information from the 'About this result' panel
Note: this object is deprecated and always returns null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AboutThisResultElement"}],"type":["object","null"]},"amp_version":{"description":"Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
Note: this check no longer appears in SERP","type":["boolean","null"]},"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"cache_url":{"description":"cached version of the page","type":["string","null"]},"checks":{"description":"array of properties detected for the SERP element
lists the properties that are true for this element
each value in the array represents a detected property
example:
if is_image is present in the array, the element contains an image
possible values in the array:is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_cited
equals null if none of the properties are detected for the element
learn more about the checks array in this Help Center article","items":{"description":"indicates whether the element contains an_image
Note: this check no longer appears in SERP","type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"extended_people_also_search":{"description":"extension of the organic element
extension of the organic result containing related search queries
Note: extension appears in SERP upon clicking on the result and then bouncing back to search results","items":{"type":["string","null"]},"type":["array","null"]},"extended_snippet":{"description":"includes additional information appended after the result description in SERP","type":["string","null"]},"faq":{"deprecated":true,"description":"frequently asked questions
questions and answers extension shown below some of Google's search results
Note: this object is deprecated and always returns null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FaqBox"}],"type":["object","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"is_featured_snippet":{"description":"indicates whether the element is a featured_snippet
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_image":{"description":"indicates whether the element contains an_image
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_malicious":{"description":"indicates whether the element is marked as malicious
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_web_story":{"description":"indicates whether the element is marked as Google web story
Note: this check no longer appears in SERP","type":["boolean","null"]},"links":{"description":"link of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"pre_snippet":{"description":"includes additional information appended before the result description in SERP","type":["string","null"]},"price":{"description":"pricing details
contains the pricing details of the product or service featured in the result;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements found in SERPnote values are returned in the ascending order, with values corresponding to advanced SERP features omitted from the results;
to get all items (including SERP features and rich snippets) with their positions, please refer to the Google Organiс Advanced SERP endpoint","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"related_result":{"description":"related result from the same domain
related result from the same domain appears as a part of the main result snippet;
you can derive the related_result snippets as \"type\": \"organic\" results by setting the group_organic_results parameter to false in the POST request","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedResult"}],"type":["object","null"]},"type":["array","null"]},"related_search_url":{"description":"URL to a similar search
URL to a new search for the same keyword(s) on related sites","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the results element in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]},"website_name":{"description":"name of the website in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_OtherSitesReviewsInfo":{"properties":{"rating":{"description":"rating in the review
information about the rating enclosed in the review on a third-party site","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"review_text":{"description":"review text
text of the review","type":["string","null"]},"title":{"description":"review title
contains a name of the third-party site where review initially appeared","type":["string","null"]},"url":{"description":"review url
URL to the a third-party site where review initially appeared","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PageContentInfo":{"properties":{"comments":{"description":"array of comments displayed on the page
contains objects with information on comments related to displayed products","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentCommentInfo"}],"type":["object","null"]},"type":["array","null"]},"contacts":{"description":"contact information
contains contact information displayed on the page","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Contacts"}],"type":["object","null"]},"footer":{"description":"content of the footer of the table
","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageSectionContentInfo"}],"type":["object","null"]},"header":{"description":"parsed content of the header
","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PageSectionContentInfo"}],"type":["object","null"]},"main_topic":{"description":"main topic on the page
you can find more information about topic priority calculation in this help center article
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopicInfo"}],"type":["object","null"]},"type":["array","null"]},"offers":{"description":"array of products displayed on the page
contains objects with information on products displayed on the page","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentOfferInfo"}],"type":["object","null"]},"type":["array","null"]},"ratings":{"description":"contains objects with rating information for the products displayed on the page
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContententRatingInfo"}],"type":["object","null"]},"type":["array","null"]},"secondary_topic":{"description":"secondary topic on the page
you can find more information about topic priority calculation in this help center article
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopicInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_PageMetaInfo":{"properties":{"broken_html":{"description":"resource errors and warnings","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourceIssueInfo"}],"type":["object","null"]},"canonical":{"description":"canonical page","type":["string","null"]},"charset":{"description":"code pageexample: 65001","type":["integer","null"]},"content":{"description":"overall information about content of the page","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlContentInfo"}],"type":["object","null"]},"cumulative_layout_shift":{"description":"Core Web Vitals metric measuring the layout stability of the pagemeasures the sum total of all individual layout shift scores for every unexpected layout shift that occurs during the entire lifespan of the page. Learn more.","type":["number","null"]},"deprecated_tags":{"description":"deprecated tags on the page","items":{"type":["string","null"]},"type":["array","null"]},"description":{"description":"content of the meta description tag","type":["string","null"]},"description_length":{"description":"length of the description tag in characters","type":["integer","null"]},"duplicate_meta_tags":{"description":"duplicate meta tags on the page","items":{"type":["string","null"]},"type":["array","null"]},"external_links_count":{"description":"number of external links on the page","format":"int64","type":["integer","null"]},"favicon":{"description":"favicon of the page","type":["string","null"]},"follow":{"description":"indicates whether a page's 'meta robots' allows crawlers to follow the links on the pageif false, the page's 'meta robots' tag contains \"nofollow\" parameter instructing crawlers not to follow the links on the page","type":["boolean","null"]},"generator":{"description":"meta tag generator","type":["string","null"]},"htags":{"additionalProperties":{"items":{"type":"string"},"type":["array","null"]},"description":"HTML header tags","type":["object","null"]},"images_count":{"description":"number of images on the page","format":"int64","type":["integer","null"]},"images_size":{"description":"total size of images on the page measured in bytes","type":["integer","null"]},"inbound_links_count":{"description":"number of internal links pointing at the page","format":"int64","type":["integer","null"]},"internal_links_count":{"description":"number of internal links on the page","format":"int64","type":["integer","null"]},"meta_keywords":{"description":"content of the keywords meta tag","type":["string","null"]},"meta_title":{"description":"meta title of the pagemeta tag in the head section of an HTML document that defines the title of a page","type":["string","null"]},"render_blocking_scripts_count":{"description":"number of scripts on the page that block page rendering","format":"int64","type":["integer","null"]},"render_blocking_stylesheets_count":{"description":"number of CSS styles on the page that block page rendering","format":"int64","type":["integer","null"]},"scripts_count":{"description":"number of scripts on the page","format":"int64","type":["integer","null"]},"scripts_size":{"description":"total size of scripts on the page measured in bytes","type":["integer","null"]},"social_media_tags":{"additionalProperties":{"type":["string","null"]},"description":"object of social media tags found on the pagecontains social media tags and their contentsupported tags include but are not limited to Open Graph and Twitter card","type":["object","null"]},"spell":{"description":"spellcheckhunspell spellcheck errors","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HunspellInfo"}],"type":["object","null"]},"stylesheets_count":{"description":"number of stylesheets on the page","format":"int64","type":["integer","null"]},"stylesheets_size":{"description":"total size of stylesheets on the page measured in bytes","type":["integer","null"]},"title":{"description":"page title","type":["string","null"]},"title_length":{"description":"length of the title tag in characters","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_PageMetrics":{"properties":{"broken_links":{"description":"number of broken links
number of broken links across all crawled pages on a target website","type":["integer","null"]},"broken_resources":{"description":"number of broken resources
the number of images and other resources with broken links","type":["integer","null"]},"checks":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"page-specific on-page check-ups","type":["object","null"]},"duplicate_content":{"description":"number of pages with duplicate content","type":["integer","null"]},"duplicate_description":{"description":"number of pages with duplicate descriptions","type":["integer","null"]},"duplicate_title":{"description":"number of pages with duplicate titles","type":["integer","null"]},"links_external":{"description":"number of external links
the number of links pointing to other websites","type":["integer","null"]},"links_internal":{"description":"number of internal links
the number of links pointing to other pages within the target website","type":["integer","null"]},"links_relation_conflict":{"description":"number of links present on the target website that may have a conflict
for example, if \"links_relation_conflict\": 2, the target website is referring to the same source by at least one internal link with the rel=\"nofollow\" attribute and by at least one dofollow link","type":["integer","null"]},"non_indexable":{"description":"number of non-indexable pages
number of pages that are blocked from being indexed by Google and other search engines by robots.txt, HTTP headers, or meta tags settings;
you can receive a list of non-indexable URLs using this endpoint","type":["integer","null"]},"onpage_score":{"description":"shows how website is optimized on a 100-point scale
this field shows how website is optimized considering critical on-page issues and warnings detected;100 is the highest possible score that means website does not have any critical on-page issues and important warnings;
note that this value depends on the number of crawled pages;
learn more about how the metric is calculated in this help center article","type":["number","null"]},"redirect_loop":{"description":"number of redirect chains that start and end at the same URL
number of redirect chains where the destination URL redirects back to the original URL","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_PageSectionContentInfo":{"properties":{"primary_content":{"description":"primary content on the page
you can find more information about content priority calculation in this help center article
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SectionContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"secondary_content":{"description":"secondary content on the page
you can find more information about content priority calculation in this help center article
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SectionContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"table_content":{"description":"content of the table on the page
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TableContentInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_PageSummary":{"properties":{"backlinks":{"description":"indicates the number of backlinks","format":"int64","type":["integer","null"]},"backlinks_spam_score":{"description":"average spam score of the backlinks pointing to the page
learn more about how the metric is calculated on this help center page","format":"int64","type":["integer","null"]},"broken_backlinks":{"description":"number of broken backlinks
number of broken backlinks pointing to the page","format":"int64","type":["integer","null"]},"broken_pages":{"description":"number of broken pages
number of pages that respond with 4xx or 5xx status codes where backlinks are pointing to","type":["integer","null"]},"first_seen":{"description":"date and time when our crawler found the backlink for the first time
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"lost_date":{"description":"date and time when the last backlink for this page was lost
indicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2017-01-24 13:20:59 +00:00","type":["string","null"]},"rank":{"description":"page rank
rank of the pagerank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]},"referring_domains":{"description":"indicates the number of referring domains","format":"int64","type":["integer","null"]},"referring_domains_nofollow":{"description":"number of domains pointing at least one nofollow link to the page","format":"int64","type":["integer","null"]},"referring_ips":{"description":"number of referring IP addresses
number of IP addresses pointing to this page","format":"int64","type":["integer","null"]},"referring_links_attributes":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"link attributes of the referring links
indicates link attributes of the referring links and link count per each attribute","type":["object","null"]},"referring_links_countries":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"ISO country codes of the referring links
indicates ISO country codes of the domains where the referring links are located and the link count per each country","type":["object","null"]},"referring_links_platform_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring platforms
indicates referring platform types and and link count per each platformcms, blogs, ecommerce, message-boards, wikis, news, organization","type":["object","null"]},"referring_links_semantic_locations":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"semantic locations of the referring links
indicates semantic elements in HTML where the referring links are located and link count per each semantic location
examples:article, section, summary","type":["object","null"]},"referring_links_tld":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"top-level domains of the referring links
contains top level domains and referring link count per each","type":["object","null"]},"referring_links_types":{"additionalProperties":{"format":"int64","type":["integer","null"]},"description":"types of referring links
indicates the types of the referring links and link count per each type
possible values:anchor, image, link, meta, canonical, alternate, redirect","type":["object","null"]},"referring_main_domains":{"description":"indicates the number of referring main domains","format":"int64","type":["integer","null"]},"referring_main_domains_nofollow":{"description":"number of main domains pointing at least one nofollow link to the page","format":"int64","type":["integer","null"]},"referring_pages":{"description":"indicates the number of pages pointing to the page","format":"int64","type":["integer","null"]},"referring_pages_nofollow":{"description":"number of referring pages pointing at least one nofollow link to the page","format":"int64","type":["integer","null"]},"referring_subnets":{"description":"number of referring subnetworks","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_PageTiming":{"properties":{"connection_time":{"description":"time to connect to a serverthe time it takes until the connection with a server is established (in milliseconds)","type":["integer","null"]},"dom_complete":{"description":"time to load resourcesthe time it takes until the page and all of its subresources are downloaded (in milliseconds)","type":["integer","null"]},"download_time":{"description":"time it takes for a browser to receive a response (in milliseconds)","type":["integer","null"]},"duration_time":{"description":"total time it takes until a browser receives a complete response from a server (in milliseconds)","type":["integer","null"]},"fetch_end":{"description":"time to complete downloading the HTML resourcethe amount of time the browser needs to complete downloading a page","type":["integer","null"]},"fetch_start":{"description":"time to start downloading the HTML resourcethe amount of time the browser needs to start downloading a page","type":["integer","null"]},"first_input_delay":{"description":"Core Web Vitals metric indicating the responsiveness of a pageThe time (in milliseconds) from when a user first interacts with your page to the time when the browser responds to that interaction. Learn more.","type":["number","null"]},"largest_contentful_paint":{"description":"Core Web Vitals metric measuring how fast the largest above-the-fold content element is displayedThe amount of time (in milliseconds) to render the largest content element visible in the viewport, from when the user requests the URL. Learn more.","type":["number","null"]},"request_sent_time":{"description":"time to send a request to a serverthe time it takes until the request to a server is sent (in milliseconds)","type":["integer","null"]},"time_to_interactive":{"description":"Time To Interactive (TTI) metricthe time it takes until the user can interact with a page (in milliseconds)","type":["integer","null"]},"time_to_secure_connection":{"description":"time to establish a secure connectionthe time it takes until the secure connection with a server is established (in milliseconds)","type":["integer","null"]},"waiting_time":{"description":"time to first byte (TTFB) in milliseconds","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_PaidSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"checks":{"description":"array of properties detected for the SERP element
lists the properties that are true for this element
each value in the array represents a detected property
example:
if is_image is present in the array, the element contains an image
possible values in the array:is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_cited
equals null if none of the properties are detected for the element
learn more about the checks array in this Help Center article","items":{"description":"indicates whether the element contains an_image
Note: this check no longer appears in SERP","type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"description_rows":{"description":"extended description
if there is none, equals null","items":{"type":["string","null"]},"type":["array","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"extra":{"additionalProperties":{"type":["string","null"]},"description":"additional information about the result","type":["object","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"is_image":{"description":"indicates whether the element contains an_image
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video
Note: this check no longer appears in SERP","type":["boolean","null"]},"links":{"description":"link of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AdLinkElement"}],"type":["object","null"]},"type":["array","null"]},"price":{"description":"pricing details
contains the pricing details of the product or service featured in the result;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":" absolute rank in SERP
absolute position among all the elements found in SERPnote values are returned in the ascending order, with values corresponding to advanced SERP features omitted from the results;
to get all items (including SERP features and rich snippets) with their positions, please refer to the Google Organiс Advanced SERP endpoint","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of the results element in SERP","type":["string","null"]},"url":{"description":" relevant URL in SERP","type":["string","null"]},"website_name":{"description":"name of the website in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_PeopleAlsoAskElement":{"properties":{"expanded_element":{"description":"expanded element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiPeopleAlsoAskExpandedElementItem"}],"type":["object","null"]},"type":["array","null"]},"seed_question":{"description":"question that triggered additional expanded elements","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PeopleAlsoAskSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PeopleAlsoAskElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_PeopleAlsoSearch":{"properties":{"cid":{"description":"google-defined client id
unique id of a local establishment
learn more about the identifier in this help center article","type":["string","null"]},"feature_id":{"description":"the unique identifier of the element in SERP
learn more about the identifier in this help center article","type":["string","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of the element in SERP
the name of the business entity for which the results are collected","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PeopleAlsoSearchSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"type":["string","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_PeriodCovered":{"properties":{"displayed_date":{"description":"period displayed in SERP
example:Mar 2, 2020 - Dec 9, 2022","type":["string","null"]},"end_date":{"description":"date and time when the period ends
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-12-09 02:00:00 +00:00","type":["string","null"]},"start_date":{"description":"date and time when the period starts
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2020-03-02 02:00:00 +00:00","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PerspectivesElement":{"properties":{"date":{"description":"the date when the page source of the element was published","type":["string","null"]},"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PerspectivesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PerspectivesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_PodcastsElement":{"properties":{"description":{"description":"description of the results element in SERP","type":["string","null"]},"time_to_play":{"description":"the total time it will take to play an episode","type":["string","null"]},"timestamp":{"description":"date and time when the result was published\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nexample:\n2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the row","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PodcastsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PodcastsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_PopularProductsElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"more_sellers":{"description":"indicates whether the product is sold by multiple sellers","type":["boolean","null"]},"price":{"description":"price indicated in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"product_identifiers":{"description":"identifiers of the product
can include the following identifiers: product_id, data_docid, gid","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ProductIdentifiers"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"seller":{"description":"seller of the product","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PopularProductsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PopularProductsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_PopularTimes":{"properties":{"popular_times_by_days":{"additionalProperties":{"items":{"description":"work hours on Sundays","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PopularWorkTimeInfo"}],"type":["object","null"]},"type":["array","null"]},"description":"popular hours
information about busy hours of the local establishment on each day of the week","type":["object","null"]}},"type":"object"},"Response0A3E90081762_PopularWorkTimeInfo":{"properties":{"popular_index":{"description":"popularity index\nrelative time-bound popularity index measured from 0 to 100;\nhigher value corresponds to a busier time of a day","type":["integer","null"]},"time":{"description":"hours in the 24-hour format","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TimeInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_PositiveConnotationDistribution":{"properties":{"negative":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"neutral":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"positive":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_PreviewImage":{"properties":{"height":{"description":"height of the preview image","type":["integer","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]},"width":{"description":"width of the preview image","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_PreviewVideos":{"properties":{"duration_time":{"description":"duration of the video","type":["string","null"]},"duration_time_seconds":{"description":"duration of the video in seconds","type":["integer","null"]},"title":{"description":"title of the video","type":["string","null"]},"url":{"description":"URL of the video","type":["string","null"]},"video_id":{"description":"ID of the video","type":["string","null"]}},"type":"object"},"Response0A3E90081762_PriceInfo":{"properties":{"currency":{"description":"currency of the listed price\nISO code of the currency applied to the price","type":["string","null"]},"current":{"description":"current price\nindicates the current price of the product or service featured in the result","format":"double","type":["number","null"]},"displayed_price":{"description":"price string in the result\nraw price string as provided in the result","type":["string","null"]},"is_price_range":{"description":"price is provided as a range\nindicates whether a price is provided in a range","type":["boolean","null"]},"max_value":{"description":"the maximum price\nthe maximum price of the product or service as indicated in the result","format":"double","type":["number","null"]},"regular":{"description":"regular price\nindicates the regular price of the product or service with no discounts applied","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_PricesByDates":{"properties":{"check_in_date":{"type":["string","null"]},"check_out_date":{"type":["string","null"]},"currency":{"description":"price currencyUSD is applied by default, unless specified in the POST array","type":["string","null"]},"price":{"description":"price per night","type":["number","null"]}},"type":"object"},"Response0A3E90081762_ProductConsiderationsElement":{"properties":{"consideration_category":{"description":"category of the consideration element
the category is indicated just above the title fo the consideration element","type":["string","null"]},"expanded_element":{"description":"expanded element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiProductConsiderationExpandedElementItem"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ProductConsiderationsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ProductConsiderationsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ProductIdentifiers":{"properties":{"data_docid":{"description":"unique identifier of the SERP data element
example:17363035694596624076","type":["string","null"]},"gid":{"description":"global product identifier on Google Shopping
example:4702526954592161872
learn more about the parameter in this help center guide","type":["string","null"]},"product_id":{"description":"unique product identifier on Google Shopping
example:4485466949985702538
learn more about the parameter in this help center guide","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ProductInfoElement":{"properties":{"data_docid":{"description":"unique identifier of the SERP data element
note that there is no full list of possible values as the data_docid is a dynamic value assigned by Google
example:17363035694596624076","type":["string","null"]},"description":{"description":"description of the product","type":["string","null"]},"features":{"description":"product features
contains snippets with the description of product features","items":{"type":["string","null"]},"type":["array","null"]},"gid":{"description":"global product identifier on Google Shopping
note that there is no full list of possible values as the gid is a dynamic value assigned by Google
if there are no values, you will get null
example:4702526954592161872
learn more about gid in this help center guide","type":["string","null"]},"images":{"description":"product images
contains urls to product images","items":{"type":["string","null"]},"type":["array","null"]},"position":{"description":"alignment of the element on the product specification page
can take the following values:right, left","type":["string","null"]},"product_id":{"description":"product_id received in a POST array
ilearn more about the parameter in this help center guide","type":["string","null"]},"rank_absolute":{"description":"absolute rank on the product specification page
absolute position among all the elements found on the product specification page","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"product rating
the popularity rate based on reviews","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"seller_reviews_count":{"description":"number of seller reviews
number of reviews on the product seller's account","format":"int64","type":["integer","null"]},"sellers":{"description":"sellers of the product
number of reviews on the product seller's account","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ProductSeller"}],"type":["object","null"]},"type":["array","null"]},"specifications":{"description":"product specifications
contains all product attributes and related data listed on the product specification page","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ShoppingSpecification"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the product","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"product url
url of the product on Google Shopping","type":["string","null"]},"variations":{"description":"variations of the product
contains brief information about different product variations","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ProductVariation"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_ProductInformationProductInformationDetailsItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationElementItem"}],"type":["object","null"]},{"properties":{"body":{"additionalProperties":{"type":["string","null"]},"description":"contains information specified about the product within the section_name","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ProductInformationProductInformationExtendedItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationElementItem"}],"type":["object","null"]},{"properties":{"contents":{"description":"contains information specified about the product within the section_name","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ProductInformationRows"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ProductInformationProductInformationTextItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationElementItem"}],"type":["object","null"]},{"properties":{"text":{"description":"text specified under the given title within the section_name","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ProductInformationRowProductInformationImageRowElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationRowElementItem"}],"type":["object","null"]},{"properties":{"alt":{"description":"alternative text of the related product image","type":["string","null"]},"url":{"description":"URL of the image","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ProductInformationRowProductInformationTextRowElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationRowElementItem"}],"type":["object","null"]},{"properties":{"text":{"description":"text of the voucher","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ProductInformationRows":{"properties":{"rows":{"description":"rows containing related product information","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantAmazonProductInformationRowElementItem"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title under which related product information appears on the Amazon product page","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ProductSeller":{"properties":{"delivery_info":{"description":"delivery information
product delivery information","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_DeliveryInfo"}],"type":["object","null"]},"price":{"description":"product price
product price details on the seller's website","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"product_availability":{"description":"product availability information
can take the following values: in_stock, limited_stock, out_of_stock, backordered, pre_order_available, on_display_to_order","type":["string","null"]},"seller_rating":{"description":"rating of the seller","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingElement"}],"type":["object","null"]},"seller_review_count":{"description":"number of seller reviews\nnumber of reviews on the product seller’s account","type":["integer","null"]},"title":{"description":"product title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"seller url
url of the page where the product is sold","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ProductVariation":{"properties":{"data_docid":{"description":"unique identifier of the SERP data element in the POST array","type":["string","null"]},"gid":{"description":"GID ID in a POST array
learn more about the parameter in this help center guide","type":["string","null"]},"product_id":{"description":"product ID in a POST array
learn more about the parameter in this help center guide","type":["string","null"]},"pvf":{"description":"product variation filter
used in the product variation URL as the identifier of the specific product variation","type":["string","null"]},"title":{"description":"name of the product seller","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"product variation URL on Google Shopping","type":["string","null"]},"variation_category":{"description":"category of the product variation
example: \"Storage Capacity\"","type":["string","null"]}},"type":"object"},"Response0A3E90081762_QuestionsAndAnswersElement":{"properties":{"answer_text":{"description":"answer included in the item","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"question_text":{"description":"question included in the item","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]},"votes":{"description":"answer upvotes from the source","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_QuestionsAndAnswersSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_QuestionsAndAnswersElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_RankChanges":{"properties":{"is_down":{"description":"rank went down
indicates how many ranked elements of this target went down in Google Search","type":["boolean","null"]},"is_new":{"description":"number of new ranked elements
indicates how many new ranked elements were found for this domain or webpage","type":["boolean","null"]},"is_up":{"description":"rank went up
indicates how many ranked elements of this target went up in Google Search","type":["boolean","null"]},"previous_rank_absolute":{"description":"previous absolute rank in SERP
indicates previous rank of the element in Google SERP;
if this element is new, the value will be null","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_RankInfo":{"properties":{"main_domain_rank":{"description":"average main domain rank
learn more about the metric and its calculation formula in this help center article","type":["integer","null"]},"page_rank":{"description":"page rank
page_rank is calculated based on the method for node ranking in a linked database - a principle used in the original Google PageRank algorithm;
learn more about the metric and how it is calculated in this help center article","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_RankedKeywordsInfo":{"properties":{"page_from_keywords_count_top_10":{"format":"int64","type":["integer","null"]},"page_from_keywords_count_top_100":{"format":"int64","type":["integer","null"]},"page_from_keywords_count_top_3":{"format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_RankedSerpElement":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"is_lost":{"description":"lost ranked elements
indicates how many ranked elements of this target were previously presented in SERPs, but weren't found during the last check","type":["boolean","null"]},"keyword_difficulty":{"description":"difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;
learn more about the metric in this help center guide","type":["integer","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"previous_updated_time":{"description":"previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-10-15 12:57:46 +00:00","type":["string","null"]},"se_results_count":{"description":"number of search results for the returned keyword","format":"int64","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"serp_item":{"description":"contains data on the SERP element
the list of supported SERP elements can be found below","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseDataforseoLabsApiElementItem"}],"type":["object","null"]},"serp_item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP
possible item types:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
note that the actual results will be returned only for organic, paid, featured_snippet, and local_pack elements","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_RatingElement":{"properties":{"position":{"description":"the alignment of the element in Google Shopping SERP
possible values:left, right","type":["string","null"]},"rating_max":{"description":"the maximum value for a rating_type","type":["integer","null"]},"rating_type":{"description":"the type of rating
here you can find the following elements: Max5, Percents, CustomMax","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"value":{"description":"value of the rating","type":["number","null"]},"votes_count":{"description":"the amount of feedback","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_RatingInfo":{"properties":{"rating_max":{"description":"the maximum value for a rating_type","type":["integer","null"]},"rating_type":{"description":"the type of rating\nhere you can find the following elements: Max5, Percents, CustomMax","type":["string","null"]},"value":{"description":"the value of the rating","format":"double","type":["number","null"]},"votes_count":{"description":"the amount of feedback","format":"int64","type":["integer","null"]}}},"Response0A3E90081762_ReasoningAiOptimizationLlmResponseElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseAiOptimizationLlmResponseElementItem"}],"type":["object","null"]},{"properties":{"sections":{"description":"reasoning chain sections
array of objects containing the reasoning chain sections generated by the LLM","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocalJustificationInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_RecipesElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"time":{"description":"the total time it takes to prepare the cook the dish","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RecipesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RecipesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_RefineProductsElement":{"properties":{"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"keyword":{"description":"keyword for the related refined search","type":["string","null"]},"refine_type":{"description":"type of search refinement","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RefineProductsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefineProductsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_RefinementChipsElement":{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"options":{"description":"further search refinement options","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RefinementChipsInfo":{"properties":{"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsElement"}],"type":["object","null"]},"type":["array","null"]},"type":{"description":"type of element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RelatedImageSearchesElement":{"deprecated":true,"properties":{"alt":{"description":"alt tag of the image","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RelatedResult":{"properties":{"about_this_result":{"deprecated":true,"description":"contains information from the 'About this result' panel
Note: this object is deprecated and always returns null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AboutThisResultElement"}],"type":["object","null"]},"amp_version":{"description":"Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
Note: this check no longer appears in SERP","type":["boolean","null"]},"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"cache_url":{"description":"cached version of the page","type":["string","null"]},"checks":{"description":"array of properties detected for the SERP element
lists the properties that are true for this element
each value in the array represents a detected property
example:
if is_image is present in the array, the element contains an image
possible values in the array:is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_cited
equals null if none of the properties are detected for the element
learn more about the checks array in this Help Center article","items":{"description":"indicates whether the element contains an_image
Note: this check no longer appears in SERP","type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"website domain","type":["string","null"]},"extended_snippet":{"description":"includes additional information appended after the result description in SERP","type":["string","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"images":{"description":"images of the component
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"is_image":{"description":"indicates whether the element contains an_image
Note: this check no longer appears in SERP","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video
Note: this check no longer appears in SERP","type":["boolean","null"]},"page":{"description":"search results page number
indicates the number of the SERP page on which the element is located","type":["integer","null"]},"pre_snippet":{"description":"includes additional information appended before the result description in SERP","type":["string","null"]},"price":{"description":"price of booking a place for the specified dates of stay","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"related_search_url":{"description":"URL to a similar search
URL to a new search for the same keyword(s) on related sites","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL","type":["string","null"]},"website_name":{"description":"name of the website in the ad element","type":["string","null"]},"xpath":{"description":"the XPath of the element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RelatedSearchesElement":{"properties":{"image_alt":{"description":"the alt tag of the product image featured in the results","type":["string","null"]},"image_url":{"description":"URL of the product image featured in the results","type":["string","null"]},"title":{"description":"product title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"the URL of the product page","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RelatedSearchesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseMerchantGoogleShoppingProductsElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"additional items present in the element
if there are none, equals null","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_RelatedSearchesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"type":["string","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ResourceMetaInfo":{"properties":{"alternative_text":{"description":"content of the image alt attribute","type":["string","null"]},"height":{"description":"image height in px","format":"double","type":["number","null"]},"original_height":{"description":"original image height in px","format":"double","type":["number","null"]},"original_width":{"description":"original image width in px","format":"double","type":["number","null"]},"title":{"description":"title","type":["string","null"]},"width":{"description":"image width in px","format":"double","type":["number","null"]}},"type":"object"},"Response0A3E90081762_ResponseDataInfo":{"properties":{"author":{"description":"author of the response","type":["string","null"]},"text":{"description":"content of the response","type":["string","null"]},"timestamp":{"description":"date and time when the response was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the response
in this case, will equal null","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ResultAvailableLanguages":{"properties":{"available_platforms":{"description":"supported LLM platforms
contains the sources of data supported for a specific location and language combination
only google and chat_gpt are currently available","items":{"type":["string","null"]},"type":["array","null"]},"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]},"responses_count":{"description":"number of LLM responses
the number of LLM responses available in the database for the certain location and language parameters","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_ReviewHighlights":{"properties":{"assessment":{"description":"feature assessment","type":["string","null"]},"feature":{"description":"reviewed feature","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ReviewMentionInfo":{"properties":{"negative_count":{"description":"count of negative reviews by criterion","format":"int64","type":["integer","null"]},"positive_count":{"description":"count of positive reviews by criterion","format":"int64","type":["integer","null"]},"positive_score":{"description":"positive score by criterion","type":["number","null"]},"title":{"description":"title of the evaluated criterion","type":["string","null"]},"total_count":{"description":"count of all reviews by criterion","format":"int64","type":["integer","null"]},"visible_by_default":{"description":"element is visible by default
indicates whether the review element is visible by default","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_ReviewResponseItemInfo":{"properties":{"text":{"description":"the content of response","type":["string","null"]},"timestamp":{"description":"the time of publication","type":["string","null"]},"title":{"description":"the title of response","type":["string","null"]}},"type":"object"},"Response0A3E90081762_RowCellInfo":{"properties":{"is_header":{"description":"content of the row cells of the header","type":["boolean","null"]},"text":{"description":"content of the row cells of the header","type":["string","null"]},"urls":{"description":"contains other URLs and anchors found in the content element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentUrlInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_ScholarlyArticlesElement":{"properties":{"author":{"description":"author","type":["string","null"]},"description":{"description":"link description","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ScholarlyArticlesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ScholarlyArticlesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ScreenshotItem":{"properties":{"image":{"description":"screenshot of the requested page
URL of the page screenshot on the DataForSEO storage
note: the page screenshot saved on the DataForSEO storage only remains accessible for one day after making the request","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SearchIntentInfo":{"properties":{"foreign_intent":{"description":"supplementary search intents
possible values: informational, navigational, commercial, transactional","items":{"type":["string","null"]},"type":["array","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"main_intent":{"description":"main search intent
possible values: informational, navigational, commercial, transactional","type":["string","null"]},"se_type":{"description":"search engine type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SearchResults":{"properties":{"breadcrumb":{"description":"breadcrumb","type":["string","null"]},"description":{"description":"result description","type":["string","null"]},"domain":{"description":"source domain","type":["string","null"]},"publication_date":{"description":"date and time when the result was published
in the format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"rank in the results","type":["integer","null"]},"title":{"description":"source title","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SearchVolumeHistoryItemInfo":{"description":"device type = desktop\ncontains historical search volume data for searches made from desktop devices","properties":{"day":{"description":"day of the month","type":["integer","null"]},"month":{"description":"month","type":["integer","null"]},"search_volume":{"description":"search volume rate","format":"int64","type":["integer","null"]},"year":{"description":"year","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_SearchVolumeHistorySearchInfo":{"properties":{"desktop":{"description":"device type = desktop
contains historical search volume data for searches made from desktop devices","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeHistoryItemInfo"}],"type":["object","null"]},"type":["array","null"]},"mobile":{"description":"device type = mobile
contains historical search volume data for searches made from mobile devices","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeHistoryItemInfo"}],"type":["object","null"]},"type":["array","null"]},"non_smartphones":{"description":"device type = non-smartphones
contains historical search volume data for searches made from feature phones (non-smartphone mobile devices)","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeHistoryItemInfo"}],"type":["object","null"]},"type":["array","null"]},"tablet":{"description":"device type = tablet
contains historical search volume data for searches made from tablets","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SearchVolumeHistoryItemInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_SearchVolumeTrend":{"properties":{"monthly":{"description":"search volume change in percent compared to the previous month","type":["integer","null"]},"quarterly":{"description":"search volume change in percent compared to the previous quarter","type":["integer","null"]},"yearly":{"description":"search volume change in percent compared to the previous year","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_SectionContentItemInfo":{"properties":{"text":{"description":"secondary content on the page\nyou can find more information about content priority calculation in this help center article","type":["string","null"]},"url":{"description":"page URL.\ndisplayed in case the text is a link anchor","type":["string","null"]},"urls":{"description":"contains other URLs and anchors found in the content element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentUrlInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_SentimentConnotationDistribution":{"properties":{"anger":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"fun":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"happiness":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"love":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"sadness":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]},"share":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ContentAnalysisSummaryInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpAiSummaryItem":{"properties":{"summary":{"description":"generated summary
summary generated by the AI model according to the parameters specified in the request","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpAiSummaryResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpAiSummaryTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpAiSummaryResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpAiSummaryItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_SerpAiSummaryTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpAiSummaryResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAdsAdvertiserElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAdsAdvertiserElementItem"}],"type":["object","null"]},{"properties":{"advertiser_id":{"description":"unique identifier of the advertiser account
can be used to obtain data on advertising campaigns from the Google Ads Search endpoint","type":["string","null"]},"approx_ads_count":{"description":"ads count
the approximate number of ads that are run by the advertiser across all available Google Ads platforms","format":"int64","type":["integer","null"]},"location":{"description":"advertiser location","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"verified":{"description":"verified advertiser account
equals true if advertiser account is verified by Google Ads","type":["boolean","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAdsDomainElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAdsAdvertiserElementItem"}],"type":["object","null"]},{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAdsMultiAccountAdvertiserElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAdsAdvertiserElementItem"}],"type":["object","null"]},{"properties":{"advertisers":{"description":"associated advertiser accounts
contains objects with data on associated advertiser accounts","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Advertiser"}],"type":["object","null"]},"type":["array","null"]},"approx_ads_count":{"description":"ads count
the approximate number of ads that are run by the advertiser across all available Google Ads platforms","format":"int64","type":["integer","null"]},"location":{"description":"advertiser location","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiModeAiOverviewElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"images":{"description":"images of the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"website links featured in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeLinkElementInfo"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"text or description of the element in SERP","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiModeAiOverviewExpandedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"components":{"description":"array of components of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewExpandedComponentInfo"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]},"title":{"description":"link anchor text","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiModeAiOverviewPaidItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewPaidElementInfo"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
the text of the ai_overview_paid formatted in the markdown markup language","type":["string","null"]},"text":{"description":"introductory text of the element in the response
text preceding the paid ad items","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiModeAiOverviewShoppingItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewShoppingElementInfo"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format
the text of the ai_overview formatted in the markdown markup language","type":["string","null"]},"title":{"description":"title of the link","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiModeAiOverviewTableElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"markdown":{"description":"text of the component in the markdwon format","type":["string","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeTableInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiModeAiOverviewVideoElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiModeAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"date":{"description":"date when the video was published or indexed
example: Apr 26, 2024","type":["string","null"]},"domain":{"description":"domain name of the reference","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"snippet":{"description":"additional information for the video","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"timestamp":{"description":"date and time when the video was published or indexed
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the element in SERP","type":["string","null"]},"url":{"description":"relevant URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiOverviewElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"images":{"description":"images of the element
if there is none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"website links featured in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"additional text of the element in SERP","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiOverviewExpandedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"components":{"description":"array of components of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOverviewExpandedComponent"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"additional text of the element in SERP","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiOverviewTableElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"table":{"description":"table element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiAiOverviewVideoElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"date":{"description":"date when the video was published or indexed
example: Apr 26, 2024","type":["string","null"]},"domain":{"description":"domain in link","type":["string","null"]},"image_url":{"description":"URL of the image","type":["string","null"]},"snippet":{"description":"additional information for the video","type":["string","null"]},"source":{"description":"web source of the shopping element
indicates the source of information included in the element","type":["string","null"]},"timestamp":{"description":"date and time when the video was published or indexed
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the element","type":["string","null"]},"url":{"description":"reference page URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiBingAiOverviewElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"images":{"description":"images of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"links":{"description":"sitelinks
the links shown below some search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"markdown":{"description":"content of the element in markdown format","type":["string","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:
left, right","type":["string","null"]},"references":{"description":"references relevant to the element
includes references to webpages that were used to generate the ai_overview_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]},"text":{"description":"text or description of the element in SERP","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiBingAiOverviewImagesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items featured in the faq_box","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"title":{"description":"title of the link element","type":["string","null"]},"url":{"description":"URL link","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiBingAiOverviewOrganicElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"links":{"description":"links featured in the faq_box_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"snippet":{"description":"text snippet from the organic result","type":["string","null"]},"title":{"description":"title of the link","type":["string","null"]},"url":{"description":"relevant URL ","type":["string","null"]},"website_name":{"description":"website name in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiBingAiOverviewVideoElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"date":{"description":"the date when the page source of the element was published","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:
left, right","type":["string","null"]},"snippet":{"description":"text snippet of the video","type":["string","null"]},"source":{"description":"source of the element
indicates the source of information included in the questions_and_answers_element","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"link anchor text","type":["string","null"]},"url":{"description":"link URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiBingAiOverviewVideosElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiBingAiOverviewElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_VideoElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiCarouselElement":{"properties":{"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"subtitle":{"description":"subtitle of the element","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceAboutElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"ceo":{"description":"Chief Executive Officer of the company","type":["string","null"]},"description":{"description":"company description","type":["string","null"]},"description_source_url":{"description":"source of information provided in description","type":["string","null"]},"displayed_name":{"description":"displayed name of the market index
example: E-mini Dow ($5)","type":["string","null"]},"employees":{"description":"number of company employees","type":["integer","null"]},"founded":{"description":"date when the company was founded
in the format: \"yyyy-mm-ddThh-mm-ssZ\"
example:1993-04-05T00:00:00Z","type":["string","null"]},"headquarters":{"description":"company headquarters","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"website":{"description":"company website","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceAssetPairElementElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"base_display_name":{"description":"full name of the base asset in a pair
example: Euro","type":["string","null"]},"base_symbol":{"description":"identifier of the base asset in a pair
example: EUR","type":["string","null"]},"displayed_name":{"description":"name of the market index as displayed on Google Finance
example: CAC 40","type":["string","null"]},"identifier":{"description":"identifier of the element
full identifier of the element that consists from ticker and market_identifier
example: PX1:INDEXDB","type":["string","null"]},"location":{"description":"location of the market index
example: Europe/Paris","type":["string","null"]},"percentage_delta":{"description":"percentage of change in value of the market index","type":["number","null"]},"price":{"description":"value of the base asset compared to the quote asset","type":["number","null"]},"price_delta":{"description":"change in price
change in price at a given timestamp","type":["number","null"]},"quote_display_name":{"description":"full name of the base asset in a pair
example: Euro","type":["string","null"]},"quote_symbol":{"description":"identifier of the quote asset in a pair
example: USD","type":["string","null"]},"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"trend":{"description":"growth trend of the market index
possible values: up, down, stable","type":["string","null"]},"url":{"description":"URL to the page of the market index on Google Finance","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceAssetPairElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceTickerSearchElementItem"}],"type":["object","null"]},{"properties":{"base_display_name":{"description":"full name of the base asset in a pair
example: Euro","type":["string","null"]},"base_symbol":{"description":"identifier of the base asset in a pair
example: EUR","type":["string","null"]},"price":{"description":"value of the base asset compared to the quote asset","type":["number","null"]},"price_delta":{"description":"change in price
change in price at a given timestamp","type":["number","null"]},"quote_display_name":{"description":"full name of the base asset in a pair
example: Euro","type":["string","null"]},"quote_symbol":{"description":"identifier of the quote asset in a pair
example: USD","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceCompareToElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceDetailsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"avg_volume":{"description":"average volume value","type":["number","null"]},"badges":{"description":"google finance badges relevant to the element
example: Futures Contract","items":{"type":["string","null"]},"type":["array","null"]},"category":{"description":"category name","type":["string","null"]},"cdp_climate_change_score":{"description":"climate change score by carbon disclosure project methodology","type":["string","null"]},"dividend_yield":{"description":"dividend yield value","type":["number","null"]},"end_day_range":{"description":"value of the end day range","type":["number","null"]},"end_year_range":{"description":"value of the end year range","type":["number","null"]},"expense_ratio":{"description":"expense ratio value","type":["number","null"]},"front_load":{"description":"front load value","type":["number","null"]},"market_cap":{"description":"market cap value","type":["number","null"]},"market_segment":{"description":"name of the relevant market segment","type":["string","null"]},"metrics_currency":{"description":"currency of the metrics","type":["string","null"]},"net_assets":{"type":["number","null"]},"open_interest":{"description":"open interest value","type":["number","null"]},"pe_ratio":{"description":"price-earnings ratio","type":["number","null"]},"previous_close":{"description":"value of the previous close","type":["number","null"]},"primary_exchange":{"description":"primary exchange value","type":["string","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"settlement_price":{"description":"settlement price value","type":["number","null"]},"start_day_range":{"description":"value of the start day range","type":["number","null"]},"start_year_range":{"description":"value of the start year range","type":["number","null"]},"volume":{"description":"total volume value","type":["number","null"]},"yield":{"description":"yield value","type":["number","null"]},"ytd_return":{"description":"year-to-date return value","type":["number","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceEarningsCalendarElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceEarningsCalendarElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceExploreMarketTrendsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"sub_title":{"description":"sub-title of the market trends element","type":["string","null"]},"title":{"description":"title of the market trends element
example: Europe, Middle East, and Africa","type":["string","null"]},"url":{"description":"URL to finance pair on Google Finance","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceFinancialElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"annual_metrics":{"description":"annual google finance metrics","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceMetricsBundleInfo"}],"type":["object","null"]},"type":["array","null"]},"quarterly_metrics":{"description":"quarterly google finance metrics","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceMetricsBundleInfo"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceFuturesChainElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"markets":{"description":"financial markets data
array of items containing market indexes and other financial information related to these indexes","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceFuturesChainElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceHeroGroupsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"markets":{"description":"financial markets data
array of items containing market indexes and other financial information related to these indexes","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Markets"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceInterestedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceMarketIndexElementElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"displayed_name":{"description":"name of the market index as displayed on Google Finance
example: CAC 40","type":["string","null"]},"identifier":{"description":"identifier of the element
full identifier of the element that consists from ticker and market_identifier
example: PX1:INDEXDB","type":["string","null"]},"index_value":{"description":"value of the market index
numerical value of the index at a given timestamp","type":["number","null"]},"index_value_delta":{"description":"change in value of the market index
change in the index_value at a given timestamp","type":["number","null"]},"location":{"description":"location of the market index
example: Europe/Paris","type":["string","null"]},"market_identifier":{"description":"market identifier
example: INDEXDB","type":["string","null"]},"percentage_delta":{"description":"percentage of change in value of the market index","type":["number","null"]},"ticker":{"description":"ticker of the market index
example: DAX","type":["string","null"]},"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"trend":{"description":"growth trend of the market index
possible values: up, down, stable","type":["string","null"]},"url":{"description":"URL to the page of the market index on Google Finance","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceMarketIndexElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceTickerSearchElementItem"}],"type":["object","null"]},{"properties":{"index_value":{"description":"value of the market index
numerical value of the index at a given timestamp","type":["number","null"]},"index_value_delta":{"description":"change in value of the market index
change in the index_value at a given timestamp","type":["number","null"]},"market_identifier":{"description":"market identifier
example: INDEXDB","type":["string","null"]},"ticker":{"description":"ticker of the market index
example: DAX","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceMarketInstrumentElementElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"displayed_name":{"description":"name of the market index as displayed on Google Finance
example: CAC 40","type":["string","null"]},"identifier":{"description":"identifier of the element
full identifier of the element that consists from ticker and market_identifier
example: PX1:INDEXDB","type":["string","null"]},"location":{"description":"location of the market index
example: Europe/Paris","type":["string","null"]},"percentage_delta":{"description":"percentage of change in value of the market index","type":["number","null"]},"price":{"description":"value of the base asset compared to the quote asset","type":["number","null"]},"price_currency":{"description":"price currency
example: USD","type":["string","null"]},"price_delta":{"description":"change in price
change in price at a given timestamp","type":["number","null"]},"ticker":{"description":"ticker of the market index
example: DAX","type":["string","null"]},"timestamp":{"description":"date and time of the value readout
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2025-02-10 09:40:00 +00:00","type":["string","null"]},"trend":{"description":"growth trend of the market index
possible values: up, down, stable","type":["string","null"]},"url":{"description":"URL to the page of the market index on Google Finance","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceMarketInstrumentElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceTickerSearchElementItem"}],"type":["object","null"]},{"properties":{"price":{"description":"value of the base asset compared to the quote asset","type":["number","null"]},"price_currency":{"description":"price currency
example: USD","type":["string","null"]},"price_delta":{"description":"change in price
change in price at a given timestamp","type":["number","null"]},"ticker":{"description":"ticker of the market index
example: DAX","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceMarketTrendsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreAdvancedItem"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceMostFollowedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceNewsElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceNewsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"sub_title":{"description":"sub-title of the news element
example: Based on Europe, Middle East, and Africa","type":["string","null"]},"title":{"description":"title of the news element
example: In the news","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinancePeopleAlsoSearchElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"market indexes data
array of items containing market indexes data;
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleFinanceQuoteElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},{"properties":{"graph_items":{"description":"values on graph","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GraphItems"}],"type":["object","null"]},"type":["array","null"]},"quote":{"description":"quoted market indexes","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleImagesCarouselElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleImagesElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpApiCarouselElement"}],"type":["object","null"]},"type":["array","null"]},"page":{"type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
note: calculate_rectangles parameter is not yet available when setting tasks for this search engine type, that’s why rectangle always equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]},"title":{"description":"title of the element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleImagesImagesSearchElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleImagesElementItem"}],"type":["object","null"]},{"properties":{"alt":{"description":"the alt tag of the image","type":["string","null"]},"encoded_url":{"description":"the URL of the cached version of the image stored on Google's servers","type":["string","null"]},"source_url":{"description":"the URL of the source image","type":["string","null"]},"subtitle":{"description":"subtitle of the result in SERP","type":["string","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleImagesRelatedSearchesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleImagesElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items of the element","items":{"type":["string","null"]},"type":["array","null"]},"page":{"type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left, right","type":["string","null"]},"rectangle":{"description":"rectangle parameters
contains cartesian coordinates and pixel dimensions of the result’s snippet in SERP
note: calculate_rectangles parameter is not yet available when setting tasks for this search engine type, that’s why rectangle always equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeRectangleInfo"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleNewsNewsSearchElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleNewsElementItem"}],"type":["object","null"]},{"properties":{"domain":{"description":"domain in SERP","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"snippet":{"description":"snippet of the result in SERP","type":["string","null"]},"time_published":{"description":"indicates the time the result was published","type":["string","null"]},"timestamp":{"description":"date and time when the news was published
in the format “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"url":{"description":"search URL with refinement parameters","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleNewsTopStoriesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleNewsElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopStoriesElement"}],"type":["object","null"]},"type":["array","null"]},"page":{"type":["integer","null"]},"position":{"description":"the alignment of the element in SERP
can take the following values:left","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleSearchByImagesImagesElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleSearchByImagesElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"related_image_searches":{"deprecated":true,"description":"contains keywords and images related to the specified search term
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedImageSearchesElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiGoogleSearchByImagesOrganicElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleSearchByImagesElementItem"}],"type":["object","null"]},{"properties":{"about_this_result":{"deprecated":true,"description":"contains information from the 'About this result' panel
'About this result' panel provides additional context about why Google returned this result for the given query;
this feature appears after clicking on the three dots next to most results","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AboutThisResultElement"}],"type":["object","null"]},"amp_version":{"description":"Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version","type":["boolean","null"]},"breadcrumb":{"description":"breadcrumb in SERP","type":["string","null"]},"cache_url":{"description":"cached version of the page","type":["string","null"]},"checks":{"items":{"description":"indicates whether the element contains a video","type":["string","null"]},"type":["array","null"]},"description":{"description":"description of the results element in SERP","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"extended_people_also_search":{"description":"extension of the organic element
extension of the organic result containing related search queries
Note: extension appears in SERP upon clicking on the result and then bouncing back to search results","items":{"type":["string","null"]},"type":["array","null"]},"extended_snippet":{"description":"includes additional information appended after the result description in SERP","type":["string","null"]},"faq":{"deprecated":true,"description":"frequently asked questions
questions and answers extension shown below some of Google's search results
if there are none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_FaqBox"}],"type":["object","null"]},"highlighted":{"description":"words highlighted in bold within the results description","items":{"type":["string","null"]},"type":["array","null"]},"images":{"description":"images of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"is_featured_snippet":{"description":"indicates whether the element is a featured_snippet","type":["boolean","null"]},"is_image":{"description":"indicates whether the element contains an image","type":["boolean","null"]},"is_malicious":{"description":"indicates whether the element is marked as malicious","type":["boolean","null"]},"is_video":{"description":"indicates whether the element contains a video","type":["boolean","null"]},"is_web_story":{"description":"indicates whether the element is marked as Google web story","type":["boolean","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"pre_snippet":{"description":"includes additional information appended before the result description in SERP","type":["string","null"]},"price":{"description":"pricing details
contains the pricing details of the product or service featured in the result","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"related_result":{"description":"related result from the same domain
related result from the same domain appears as a part of the main result snippet;
you can derive the related_result snippets as \"type\": \"organic\" results by setting the group_organic_results parameter to false in the POST request","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RelatedResult"}],"type":["object","null"]},"type":["array","null"]},"related_search_url":{"description":"URL to a similar search
URL to a new search for the same keyword(s) on related sites","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"website_name":{"description":"name of the website in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphAiOverviewItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"asynchronous_ai_overview":{"description":"indicates whether the element is loaded asynchronously
if true, the ai_overview element is loaded asynchronously;
if false, the ai_overview element is loaded from cache;
to obtain the content of ai_overview elements, use the load_async_ai_overview parameter in the POST request","type":["boolean","null"]},"items":{"description":"contains results featured in the 'hotels_pack' element of SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphCarouselItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:action:listen_artist","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphDescriptionItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"text":{"description":"text or description of the element in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphExpandedItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:kc:/local:place qa","type":["string","null"]},"expanded_element":{"description":"link of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphExpandedElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"title":{"description":"title of the result in SERP","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphHotelsBookingItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:kc:/local:hotel booking","type":["string","null"]},"date_from":{"description":"starting date of stay
in the format “year-month-date”
example:
2019-11-15","type":["string","null"]},"date_to":{"description":"ending date of stay
in the format “year-month-date”
example:
2019-11-17","type":["string","null"]},"items":{"description":"popular keywords relevant to the initial search query
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphHotelsBookingElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"title":{"description":"title of a given link element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphImagesItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphImagesElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphListItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:ss:/webfacts:net_worth","type":["string","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphListElement"}],"type":["object","null"]},"type":["array","null"]},"link":{"description":"link of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"title":{"description":"title of the item","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphPartItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:kc:/local:place qa","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]},"title":{"description":"title of the place","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphRowItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:kc:/common/topic:social media presence","type":["string","null"]},"links":{"description":"sitelinks
the links shown below some of Google's search results
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LinkElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"text":{"description":"reference text
text snippet from the page that was used to generate the ai_overview_element","type":["string","null"]},"title":{"description":"title of the link","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiKnowledgeGraphShoppingItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiKnowledgeGraphElementItem"}],"type":["object","null"]},{"properties":{"data_attrid":{"description":"google defined data attribute ID
example:kc:/shopping/gpc:organic-offers","type":["string","null"]},"items":{"description":"keywords relevant to the initial search query
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_KnowledgeGraphShoppingElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"title":{"description":"title of a given link element","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiMapsPaidItemElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleMapsElementItem"}],"type":["object","null"]},{"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiMapsSearchElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleMapsElementItem"}],"type":["object","null"]},{"properties":{"additional_categories":{"description":"additional business categories
additional Google My Business categories that describe the services provided by the business entity in more detail","items":{"type":["string","null"]},"type":["array","null"]},"address":{"description":"address line
address of the local establishment featured in the element","type":["string","null"]},"address_info":{"description":"object containing address components of the local establishment","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AddressInfo"}],"type":["object","null"]},"book_online_url":{"description":"URL in the 'book online' button of the element
URL directing users to the online booking or order page of the business entity","type":["string","null"]},"category":{"description":"business category
Google My Business general category that best describes the services provided by the business entity","type":["string","null"]},"category_ids":{"description":"global category IDs
universal category IDs that do not change based on the selected country","items":{"type":["string","null"]},"type":["array","null"]},"cid":{"description":"google-defined client id
unique id of a local establishment;
can be used with Google Reviews API to get a full list of reviews","type":["string","null"]},"contact_url":{"description":"URL of the preferred contact page","type":["string","null"]},"contributor_url":{"description":"URL of the user's or entity's Local Guides profile, if available","type":["string","null"]},"feature_id":{"description":"the unique identifier of the element in SERP","type":["string","null"]},"hotel_rating":{"description":"hotel class rating
class ratings range between 1-5 stars, learn more
if there is no hotel class rating information, the value will be null","type":["number","null"]},"is_claimed":{"description":"indicates whether ownership of this local establishment is claimed","type":["boolean","null"]},"is_directory_item":{"description":"indicates whether this local establishment is a directory ","type":["boolean","null"]},"latitude":{"description":"latitude coordinate of the local establishments in google maps
example:\"latitude\": 51.584091","type":["number","null"]},"local_justifications":{"description":"Google local justifications
snippets of text that \"justify\" why the business is showing up for search query","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocalJustificationInfo"}],"type":["object","null"]},"type":["array","null"]},"longitude":{"description":"longitude coordinate of the local establishment in google maps
example:\"longitude\": -0.31365919999999997","type":["number","null"]},"main_image":{"description":"URL of the main image featured in Google My Business profile","type":["string","null"]},"original_title":{"description":"original title of the element
original title not translated by Google","type":["string","null"]},"phone":{"description":"phone number
phone number of the local establishment featured in the element","type":["string","null"]},"place_id":{"description":"unique place identifier
place id of the local establishment featured in the element","type":["string","null"]},"price_level":{"description":"property price level
can take values: inexpensive, moderate, expensive, very_expensive
if there is no price level information, the value will be null","type":["string","null"]},"snippet":{"description":"element snippet
contains the address and other information about the local establishment featured in the element","type":["string","null"]},"total_photos":{"description":"total count of images featured in Google My Business profile","format":"int64","type":["integer","null"]},"work_hours":{"description":"open hours
information about work hours of the local establishment","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_WorkHours"}],"type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiPeopleAlsoAskAiOverviewExpandedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiPeopleAlsoAskExpandedElementItem"}],"type":["object","null"]},{"properties":{"asynchronous_ai_overview":{"description":"indicates whether the element is loaded asynchronously
if true, the people_also_ask_ai_overview_expanded_element element is loaded asynchronously;
if false, the people_also_ask_ai_overview_expanded_element element is loaded from cache","type":["boolean","null"]},"items":{"description":"items present in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAiOverviewElementItem"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiPeopleAlsoAskExpandedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiPeopleAlsoAskExpandedElementItem"}],"type":["object","null"]},{"properties":{"description":{"description":"description","type":["string","null"]},"domain":{"description":"source domain","type":["string","null"]},"featured_title":{"description":"the title of the featured snippets source page","type":["string","null"]},"images":{"description":"images of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeImagesElementInfo"}],"type":["object","null"]},"type":["array","null"]},"table":{"description":"results table
if there are none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the carousel item","type":["string","null"]},"url":{"description":"relevant URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiProductConsiderationsAiOverviewExpandedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiProductConsiderationExpandedElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"items present in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOverviewElement"}],"type":["object","null"]},"type":["array","null"]},"references":{"description":"additional references relevant to the item
includes references to webpages that may have been used to generate the ai_overview","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewReferenceInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiProductConsiderationsExpandedElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiProductConsiderationExpandedElementItem"}],"type":["object","null"]},{"properties":{"about_this_result":{"deprecated":true,"description":"contains information from the 'About this result' panel
Note: this object is deprecated and always returns null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AboutThisResultElement"}],"type":["object","null"]},"breadcrumb":{"description":"breadcrumb of the Ad element in SERP","type":["string","null"]},"domain":{"description":"source domain","type":["string","null"]},"featured_title":{"description":"the title of the featured snippets source page","type":["string","null"]},"related_searches":{"items":{"type":["string","null"]},"type":["array","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the carousel item","type":["string","null"]},"url":{"description":"relevant URL","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiYoutubeChannelElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem"}],"type":["object","null"]},{"properties":{"description":{"description":"description of the channel","type":["string","null"]},"highlighted":{"description":"highlighted keywords in the description","items":{"type":["string","null"]},"type":["array","null"]},"is_verified":{"description":"indicates whether the channel has a \"verified\" label","type":["boolean","null"]},"logo":{"description":"the URL of the page where the logo image is hosted","type":["string","null"]},"name":{"description":"name of the channel","type":["string","null"]},"video_count":{"description":"the number of videos counted on the channel","format":"int64","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiYoutubePlaylistElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem"}],"type":["object","null"]},{"properties":{"channel_logo":{"description":"the URL of the page where the logo image of the channel is hosted","type":["string","null"]},"channel_name":{"description":"the name of the channel where the video is published","type":["string","null"]},"channel_url":{"description":"the URL of the channel where the video is published","type":["string","null"]},"playlist_id":{"description":"ID of the video","type":["string","null"]},"preview_videos":{"description":"information about preview videos
array of objects containing information about videos in the preview block of the playlist element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PreviewVideos"}],"type":["object","null"]},"type":["array","null"]},"thumbnail_url":{"description":"the URL of the page where the thumbnail is hosted","type":["string","null"]},"title":{"description":"title of the video","type":["string","null"]},"videos_count":{"description":"the number of videos in playlist","format":"int64","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiYoutubeVideoElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem"}],"type":["object","null"]},{"properties":{"badges":{"description":"video badges
example:
New, CC, 4K
","items":{"type":["string","null"]},"type":["array","null"]},"channel_logo":{"description":"the URL of the page where the logo image of the channel is hosted","type":["string","null"]},"channel_name":{"description":"the name of the channel where the video is published","type":["string","null"]},"channel_url":{"description":"the URL of the channel where the video is published","type":["string","null"]},"description":{"description":"description of the channel","type":["string","null"]},"duration_time":{"description":"duration of the video","type":["string","null"]},"duration_time_seconds":{"description":"duration of the video in seconds","type":["integer","null"]},"highlighted":{"description":"highlighted keywords in the description","items":{"type":["string","null"]},"type":["array","null"]},"is_live":{"description":"indicates whether the video is a live broadcast","type":["boolean","null"]},"is_movie":{"description":"indicates whether the video is a movie","type":["boolean","null"]},"is_shorts":{"description":"indicates whether the video is shorts","type":["boolean","null"]},"publication_date":{"description":"the date when the video is published","type":["string","null"]},"thumbnail_url":{"description":"the URL of the page where the thumbnail is hosted","type":["string","null"]},"timestamp":{"description":"date and time when the result is published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2022-11-15 12:57:46 +00:00
","type":["string","null"]},"title":{"description":"title of the video","type":["string","null"]},"video_id":{"description":"ID of the video","type":["string","null"]},"views_count":{"description":"number of views of the video","format":"int64","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpApiYoutubeVideoPaidElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem"}],"type":["object","null"]},{"properties":{"badges":{"description":"video badges
example:
New, CC, 4K
","items":{"type":["string","null"]},"type":["array","null"]},"channel_logo":{"description":"the URL of the page where the logo image of the channel is hosted","type":["string","null"]},"channel_name":{"description":"the name of the channel where the video is published","type":["string","null"]},"channel_url":{"description":"the URL of the channel where the video is published","type":["string","null"]},"description":{"description":"description of the channel","type":["string","null"]},"duration_time":{"description":"duration of the video","type":["string","null"]},"duration_time_seconds":{"description":"duration of the video in seconds","type":["integer","null"]},"highlighted":{"description":"highlighted keywords in the description","items":{"type":["string","null"]},"type":["array","null"]},"is_live":{"description":"indicates whether the video is a live broadcast","type":["boolean","null"]},"is_movie":{"description":"indicates whether the video is a movie","type":["boolean","null"]},"is_shorts":{"description":"indicates whether the video is shorts","type":["boolean","null"]},"publication_date":{"description":"the date when the video is published","type":["string","null"]},"thumbnail_url":{"description":"the URL of the page where the thumbnail is hosted","type":["string","null"]},"timestamp":{"description":"date and time when the result is published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2022-11-15 12:57:46 +00:00
","type":["string","null"]},"title":{"description":"title of the video","type":["string","null"]},"video_id":{"description":"ID of the video","type":["string","null"]},"views_count":{"description":"number of views of the video","format":"int64","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBaiduLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
only City location_type is supported for all countries except China (where Country is also supported);
don't match locations by location_code_parent because the results for Region and Country-level results for most countries are not supported by Baidu SERP API","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
only City is supported for all countries except China (where Country is also supported)","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBaiduLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
images, local_pack, map, organic, paid, related_searches, video, stocks_box, dictionary, shopping","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskGetRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:organic, paid","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskGetRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskGetRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBaiduOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBaiduOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:
`\"location_code\": 9041134`,
`\"location_name\": \"Vienna International Airport,Lower Austria,Austria\"`,
`\"location_code_parent\": 20044`
`\"location_name\": \"Lower Austria,Austria\"`","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
indicates the geographic classification of the location
example:
`\"location_type\": \"Country\"`, or `\"location_type\": \"State\"`","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
answer_box, carousel, events, featured_snippet, hotels_pack, images, jobs, local_pack, map, organic, paid, people_also_ask, people_also_search, questions_and_answers,recipes, related_searches, shopping, top_stories, video, ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicLiveRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types: organic, paid","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicLiveRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicLiveRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
answer_box, carousel, events, featured_snippet, hotels_pack, images, jobs, local_pack, map, organic, paid, people_also_ask, people_also_search, questions_and_answers,recipes, related_searches, shopping, top_stories, video, ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskGetRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types: organic, paid","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items inside the element
array of 8 search queries related to the keyword","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseBingSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskGetRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskGetRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpBingOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpBingOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpBingOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:\"location_code\": 9041134,
\"location_name\": \"Vienna International Airport,Lower Austria,Austria\",
\"location_code_parent\": 20044location_code_parent corresponds to:\"location_code\": 20044,","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
\"location_name\": \"Lower Austria,Austria\"
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:ads_muti_account_advertiser, ads_advertiser, ads_domain","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiAdsAdvertiserElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAdsAdvertisersTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsAdvertisersTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:
`\"location_code\": 9041134`,
`\"location_name\": \"Vienna International Airport,Lower Austria,Austria\"`,
`\"location_code_parent\": 20044`
`\"location_name\": \"Lower Austria,Austria\"`","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
in this case, equals null","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:ads_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AdsSearch"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAdsSearchTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAdsSearchTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAiModeLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items present in the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiModeAiOverviewInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAiModeTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAiModeTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:autocomplete","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Autocomplete"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, will equal null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:autocomplete","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Autocomplete"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, will equal null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleAutocompleteTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleAutocompleteTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item type: dataset","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Dataset"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item type: dataset","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Dataset"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleDatasetInfoTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetInfoTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item type: dataset","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Dataset"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item type: dataset","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Dataset"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleDatasetSearchTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleDatasetSearchTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreAdvancedItem":{"properties":{"gainers":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceMarketTrendsElement"}],"type":["object","null"]},"type":["array","null"]},"losers":{"items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceMarketTrendsElement"}],"type":["object","null"]},"type":["array","null"]},"most_active":{"description":"array of items
this array can take the following names: most_active, gainers, losers","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleFinanceMarketTrendsElement"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_hero_groups, google_finance_interested, google_finance_news, google_finance_earnings_calendar, google_finance_most_followed, google_finance_market_trends, google_finance_people_also_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_hero_groups, google_finance_interested, google_finance_news, google_finance_earnings_calendar, google_finance_most_followed, google_finance_market_trends, google_finance_people_also_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"market indexes related to the market trends element
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceExploreTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceExploreTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_hero_groups, google_finance_explore_market_trends, google_finance_news, google_finance_interested, google_finance_people_also_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_hero_groups, google_finance_explore_market_trends, google_finance_news, google_finance_interested, google_finance_people_also_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"market indexes related to the market trends element
possible type of items: google_finance_asset_pair_element, google_finance_market_instrument_element, google_finance_market_index_element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceMarketsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceMarketsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_hero_groups, google_finance_quote, google_finance_compare_to, google_finance_news, google_finance_financial, google_finance_futures_chain, google_finance_details, google_finance_about, google_finance_interested, google_finance_people_also_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_hero_groups, google_finance_quote, google_finance_compare_to, google_finance_news, google_finance_financial, google_finance_futures_chain, google_finance_details, google_finance_about, google_finance_interested, google_finance_people_also_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"market indexes related to the market trends element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceQuoteTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceQuoteTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of search results found in SERP
array of items containing market indexes data;
possible type of items: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceTickerSearchElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP;
possible item types: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of search results found in SERP
array of items containing market indexes data;
possible type of items: google_finance_market_index, google_finance_asset_pair, google_finance_market_instrument","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleFinanceTickerSearchElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
in this case, the value will be null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleFinanceTickerSearchTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleFinanceTickerSearchTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:carousel, images_search, related_searches","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleImagesElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleImagesLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleImagesLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:carousel, images_search, related_searches","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleImagesElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleImagesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleImagesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleImagesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:google_jobs_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_GoogleJobsItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
in this case, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleJobsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleJobsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleJobsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:local_pack","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocalPackSerpElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array
","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:local_pack","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_LocalPackSerpElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLocalFinderTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocalFinderTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:
`\"location_code\": 9041134`,
`\"location_name\": \"Vienna International Airport,Lower Austria,Austria\"`,
`\"location_code_parent\": 20044`
`\"location_name\": \"Lower Austria,Austria\"`","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
indicates the geographic classification of the location
example:
`\"location_type\": \"Country\"`, or `\"location_type\": \"State\"`","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results
Note: to check location-specific results, follow the provided check url, scroll up and down, then click the \"Search this area\" button","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:maps_search, maps_paid_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleMapsElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array
","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleMapsLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results
Note: to check location-specific results, follow the provided check url, scroll up and down, then click the \"Search this area\" button","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:maps_search, maps_paid_item","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleMapsElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleMapsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleMapsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleMapsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleMapsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"includes_non_news_search_results":{"description":"indicates whether the response contains non-news search results in addition to news content","type":["boolean","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:top_stories, news_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleNewsElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleNewsLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleNewsLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"includes_non_news_search_results":{"description":"indicates whether the response contains non-news search results in addition to news content","type":["boolean","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:top_stories, news_search","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleNewsElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleNewsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleNewsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleNewsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine resultsyou can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was receivedin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERPcontains types of search results (items) found in SERP.possible item types:answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST arraythe keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total search results pages retrievedtotal number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engineif the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicLiveRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
however, this endpoint provides data for featured_snippet, organic and paid types only
to get all items (inlcuding SERP features and rich snippets) found in the returned SERP, please refer to the Google Organiс Advanced SERP endpoint","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total search results pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicLiveRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicLiveRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sitesai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"link of the element","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total search results pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskGetRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
however, this endpoint provides data for featured_snippet, organic and paid types only;
to get all items (including SERP features and rich snippets) found in the returned SERP, please refer to the Google Organiс Advanced SERP endpoint","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total search results pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
if there are none, the value is null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection;
if there is none, the value is null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskGetRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskGetRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleSearchByImageTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"image_url":{"description":"URL specified in a POST array","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
organic,
images","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items featured in the faq_box","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiGoogleSearchByImagesElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword Google associated with the specified image","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleSearchByImageTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleSearchByImageTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleSearchByImageTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
can take the following values: search_by_image","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpGoogleSearchByImageTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpGoogleSearchByImageTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"last_updated_time":{"description":"date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"previous_updated_time":{"description":"previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-10-15 12:57:46 +00:00","type":["string","null"]},"se_results_count":{"description":"number of search results for the returned keyword","format":"int64","type":["integer","null"]},"se_type":{"description":"search engine type","type":["string","null"]},"serp_item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP
possible item types:answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
note that the actual results will be returned only for organic, paid, featured_snippet, and local_pack elements","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:images, local_pack, map, organic, paid, related_searches, video","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskGetRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:images, local_pack, map, organic, paid, related_searches, video
however, this endpoint provides data for organic and paid types onlyitems array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskGetRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskGetRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpNaverOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpNaverOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpNaverOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpScreenshotResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpScreenshotTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpScreenshotResultInfo":{"properties":{"items":{"description":"items array","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ScreenshotItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"number of items in the results array","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_SerpScreenshotTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpScreenshotResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpSeznamLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
only City location_type is supported for all countries except China (where Country is also supported);
don't match locations by location_code_parent because the results for Region and Country-level results for most countries are not supported by Baidu SERP API","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpSeznamLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:images, local_pack, organic, related_searches, top_stories, featured_snippet, video, shopping","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskGetRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:images, local_pack, organic, related_searches, top_stories, featured_snippet, video
however, this endpoint provides data for the organic type onlyitems array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskGetRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskGetRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpSeznamOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpSeznamOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:
`\"location_code\": 9041134`,
`\"location_name\": \"Vienna International Airport,Lower Austria,Austria\"`,
`\"location_code_parent\": 20044`
`\"location_name\": \"Lower Austria,Austria\"`","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
indicates the geographic classification of the location
example:
`\"location_type\": \"Country\"`, or `\"location_type\": \"State\"`","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicLiveHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicLiveHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicLiveRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
You can use it to make sure that we provided exact results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview;
note that this array contains all types of search results found in the returned SERP;
however, this endpoint provides data for organic, paid, and featured_snippet types only;
to get all items (including SERP features and rich snippets) found in the returned SERP, please refer to the Yahoo Organiс Advanced SERP endpoint","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicLiveRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicLiveRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"additional items present in the element
if there are none, equals null","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetHtmlResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskGetHtmlTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetHtmlResultInfo":{"properties":{"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_HtmlItemInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetHtmlTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskGetHtmlResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetRegularResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskGetRegularTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetRegularResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results found in SERP
contains types of all search results (items) found in the returned SERP
possible item types:featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview;
note that this array contains all types of search results found in the returned SERP;
however, this endpoint provides data for organic, paid, and featured_snippet types only;
to get all items (including SERP features and rich snippets) found in the returned SERP, please refer to the Yahoo Organiс Advanced SERP endpoint","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"items in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"pages_count":{"description":"total pages retrieved
total number of retrieved SERPs in the result","format":"int64","type":["integer","null"]},"refinement_chips":{"description":"search refinement chips
equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RefinementChipsInfo"}],"type":["object","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskGetRegularTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskGetRegularResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results
in this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYahooOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYahooOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYahooOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeLanguagesResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeLanguagesTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeLanguagesResultInfo":{"properties":{"language_code":{"description":"language code according to ISO 639-1","type":["string","null"]},"language_name":{"description":"language name","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeLanguagesTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeLanguagesResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeLocationsResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeLocationsTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeLocationsResultInfo":{"properties":{"country_iso_code":{"description":"ISO country code of the location","type":["string","null"]},"location_code":{"description":"location code","type":["integer","null"]},"location_code_parent":{"description":"the code of the superordinate location
example:
`\"location_code\": 9041134`,
`\"location_name\": \"Vienna International Airport,Lower Austria,Austria\"`,
`\"location_code_parent\": 20044`
`\"location_name\": \"Lower Austria,Austria\"`","type":["integer","null"]},"location_name":{"description":"full name of the location","type":["string","null"]},"location_type":{"description":"location type
indicates the geographic classification of the location
example:
`\"location_type\": \"Country\"`, or `\"location_type\": \"State\"`","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeLocationsTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeLocationsResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP contains types of search results (items) found in SERP. possible item types: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array the keyword is returned with decoded %## (plus character '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":"total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item types:
youtube_channel, youtube_video, youtube_video_paid","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiYoutubeOrganicElementItem"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"keyword":{"description":"keyword received in a POST array
the keyword is returned with decoded %## (plus symbol '+' will be decoded to a space character)","type":["string","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"se_results_count":{"description":" total number of results in SERP","format":"int64","type":["integer","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of resultsin this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeOrganicTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeOrganicTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"comments_count":{"description":"number of comments on the video","format":"int64","type":["integer","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item:youtube_comment","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_YoutubeComment"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"title":{"description":"title of the video","type":["string","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"comments_count":{"description":"number of comments on the video","format":"int64","type":["integer","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item:youtube_comment","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_YoutubeComment"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"title":{"description":"title of the video","type":["string","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of resultsin this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoCommentsTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoCommentsTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoLiveAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results\nyou can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nexample:\n2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP\ncontains types of search results (items) found in SERP.\npossible item:\nyoutube_video_info","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_YoutubeVideoInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine\nif the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTaskGetAdvancedResultInfo":{"properties":{"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item:
youtube_video_info","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_YoutubeVideoInfo"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of resultsin this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoInfoTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoInfoTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesLiveAdvancedResultInfo":{"properties":{"category":{"description":"the category the video belongs toNote: this field is deprecated and always returns null","type":["string","null"]},"check_url":{"description":"direct URL to search engine resultsyou can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was receivedin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERPcontains types of search results (items) found in SERP.possible item:youtube_subtitles","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_YoutubeSubtitles"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"origin_language":{"description":"language code of original text","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engineif the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"subtitles_count":{"description":"number of subtitles in the video","format":"int64","type":["integer","null"]},"title":{"description":"title of the video","type":["string","null"]},"translate_language":{"description":"language code of translated text","type":["string","null"]},"unsupported_language":{"description":"indicates whether the language is unsupported by the system","type":["boolean","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesLiveAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskGetAdvancedResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskGetAdvancedTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskGetAdvancedResultInfo":{"properties":{"category":{"description":"the category the video belongs to
Note: this field is deprecated and always returns null","type":["string","null"]},"check_url":{"description":"direct URL to search engine results
you can use it to make sure that we provided accurate results","type":["string","null"]},"datetime":{"description":"date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"item_types":{"description":"types of search results in SERP
contains types of search results (items) found in SERP.
possible item:youtube_subtitles","items":{"type":["string","null"]},"type":["array","null"]},"items":{"description":"elements of search results found in SERP","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_YoutubeSubtitles"}],"type":["object","null"]},"type":["array","null"]},"items_count":{"description":"the number of results returned in the items array","format":"int64","type":["integer","null"]},"language_code":{"description":"language code in a POST array","type":["string","null"]},"location_code":{"description":"location code in a POST array","type":["integer","null"]},"origin_language":{"description":"language code of original text","type":["string","null"]},"se_domain":{"description":"search engine domain in a POST array","type":["string","null"]},"spell":{"description":"autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SpellInfo"}],"type":["object","null"]},"subtitles_count":{"description":"number of subtitles in the video","format":"int64","type":["integer","null"]},"title":{"description":"title of the video","type":["string","null"]},"translate_language":{"description":"language code of translated text","type":["string","null"]},"unsupported_language":{"description":"indicates whether the language is unsupported by the system","type":["boolean","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskGetAdvancedTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskGetAdvancedResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskPostResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskPostTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTaskPostTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of resultsin this case, the value will be null","type":["object","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTasksReadyResponseInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseInfo"},{"properties":{"tasks":{"description":"array of tasks","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesTasksReadyTaskInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTasksReadyResultInfo":{"properties":{"date_posted":{"description":"date when the task was posted (in the UTC format)","type":["string","null"]},"endpoint_advanced":{"description":"URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_html":{"description":"URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will be null","type":["string","null"]},"endpoint_regular":{"description":"URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will be null","type":["string","null"]},"id":{"description":"task identifier of the completed task
unique task identifier in our system in the UUID format","type":["string","null"]},"se":{"description":"search engine specified when setting the task","type":["string","null"]},"se_type":{"description":"type of search engine
example: {{low_se_type_under}}","type":["string","null"]},"tag":{"description":"user-defined task identifier","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SerpYoutubeVideoSubtitlesTasksReadyTaskInfo":{"allOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseResponseTaskInfo"},{"properties":{"result":{"description":"array of results","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SerpYoutubeVideoSubtitlesTasksReadyResultInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ShoppingElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"marketplace":{"description":"merchant account provider
commerce site that hosts products or websites of individual sellers under the same merchant account
example:by Google","type":["string","null"]},"marketplace_url":{"description":"relevant marketplace URL
URL of the page on the marketplace website where the product is hosted","type":["string","null"]},"price":{"description":"price indicated in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ShoppingSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ShoppingElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_ShoppingSpecification":{"properties":{"block_name":{"description":"name of the block of product attributes
indicates the name of the product specification section in which the related element is listed","type":["string","null"]},"specification_name":{"description":"product attribute
attribute name of the product data specification","type":["string","null"]},"specification_value":{"description":"content of the specification","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ShortVideosElement":{"properties":{"domain":{"description":"domain where a link points","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_ShortVideosSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ShortVideosElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_SocialMetricsInfo":{"properties":{"like_count":{"description":"likes count","format":"int64","type":["integer","null"]},"type":{"description":"type of element","type":["string","null"]}}},"Response0A3E90081762_Source":{"properties":{"domain":{"description":"domain of the source where the review was posted","type":["string","null"]},"image":{"description":"featured image of the source","type":["string","null"]},"title":{"description":"name of the source where the review was posted","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SourceInfo":{"properties":{"domain":{"description":"source domain in SERP","type":["string","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"publication_date":{"description":"date and time when the result was published
in the format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"snippet":{"description":"source description","type":["string","null"]},"source_name":{"description":"source name","type":["string","null"]},"thumbnail":{"description":"source thumbnail","type":["string","null"]},"title":{"description":"source title","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_Sources":{"properties":{"domain":{"description":"source domain","type":["string","null"]},"markdown":{"description":"content of the element in markdown format
content of the result formatted in the markdown markup language","type":["string","null"]},"publication_date":{"description":"date and time when the result was published
in the format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"rank":{"description":"rank in the results","type":["integer","null"]},"snippet":{"description":"source description","type":["string","null"]},"source_name":{"description":"source name","type":["string","null"]},"thumbnail":{"description":"source thumbnail","type":["string","null"]},"title":{"description":"source title","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SpecialOfferInfo":{"properties":{"coupon_code":{"description":"code of coupon discount","type":["string","null"]},"coupon_info":{"description":"information on coupon discount","type":["string","null"]},"domain":{"description":"domain in SERP","type":["string","null"]},"fixed_discount":{"description":"amount of the fixed discount","format":"int64","type":["number","null"]},"fixed_discount_currency":{"description":"currency of the fixed discount","type":["string","null"]},"percentage_discount":{"description":"percentage of the discount","format":"int64","type":["number","null"]},"sub_title":{"description":"subtitle of the special offer","type":["string","null"]},"title":{"description":"product title","type":["string","null"]},"url":{"description":"URL to the product page on the seller's website
Note: this field is deprecated and will return null","type":["string","null"]}},"type":"object"},"Response0A3E90081762_SpellInfo":{"properties":{"keyword":{"description":"keyword obtained as a result of search engine autocorrection\n the results will be provided for the corrected keyword","type":["string","null"]},"type":{"description":"type of autocorrection\n possible values:\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n note: Yahoo and Yandex support only the following autocorrection type:\n including_results_for","type":["string","null"]}}},"Response0A3E90081762_SslInfo":{"properties":{"certificate_expiration_date":{"description":"ssl certificate expiration date
the date and time when the ssl certificate expires
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"certificate_hash":{"description":"ssl certificate hash
the version of the ssl certificate's hash function","type":["string","null"]},"certificate_issuer":{"description":"ssl certificate authority
the entity that issued the detected ssl certificate","type":["string","null"]},"certificate_subject":{"description":"ssl certificate subject
the entity associated with the public key","type":["string","null"]},"certificate_version":{"description":"ssl certificate version
indicates the version of X.509 used by an ssl certificate","type":["integer","null"]},"valid_certificate":{"description":"ssl certificate validity
indicates whether the ssl certificate detected on a website is not expired, suspended, revoked or invalid","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_StocksBoxSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"domain":{"description":"domain of the website hosting the video","type":["string","null"]},"graph":{"description":"contains data provided in the graph of the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Graph"}],"type":["object","null"]},"price":{"description":"price indicated in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_PriceInfo"}],"type":["object","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"snippet":{"description":"text alongside the link title","type":["string","null"]},"source":{"description":"source of the element
indicates the source of information included in the recipes_element","type":["string","null"]},"table":{"description":"table present in the element
the header and content of the table present in the element","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Table"}],"type":["object","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_StoresCountInfo":{"properties":{"count":{"description":"number of stores that offer the product","type":["integer","null"]},"count_from_text":{"description":"whether the number of stores is taken from text
indicates whether the number of stores is taken from displayed_text;
if the API finds the exact number of stores in the HTML code of the Google Shopping page, this parameter is false;
if the API cannot find the number of stores in the HTML code of the page, it takes the number from the displayed_text;
in this case, the parameter is true","type":["boolean","null"]},"displayed_text":{"description":"text displayed on the Google Shopping page","type":["string","null"]}},"type":"object"},"Response0A3E90081762_StreamingQualityElement":{"properties":{"bitrate":{"description":"bit rate of the video","type":["integer","null"]},"fps":{"description":"frame rate of the video","type":["integer","null"]},"height":{"description":"video height in pixels","type":["integer","null"]},"label":{"description":"label of the quality element","type":["string","null"]},"mime_type":{"description":"media type of the video","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"width":{"description":"video width in pixels","format":"int64","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_Subtitles":{"properties":{"is_auto_generated":{"description":"defines if subtitles are auto generated","type":["boolean","null"]},"is_translatable":{"description":"defines if subtitles are translatable","type":["boolean","null"]},"language":{"description":"language of subtitles","type":["string","null"]}},"type":"object"},"Response0A3E90081762_Table":{"properties":{"table_content":{"description":"the content of the table\none line of the table in this element of the array","items":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["array","null"]},"table_element":{"description":"name assigned to the table element\npossible values:\ntable_element","type":["string","null"]},"table_header":{"description":"column names","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_TableContentInfo":{"properties":{"body":{"description":"content of the body of the table","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TableContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"footer":{"description":"content of the footer of the table","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TableContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"header":{"description":"parsed content of the header","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TableContentItemInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_TableContentItemInfo":{"properties":{"row_cells":{"description":"content of the row cells of the header","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RowCellInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_TargetInfo":{"properties":{"cms":{"description":"content management system","type":["string","null"]},"country":{"description":"country code that the target domain is determined to belong to","type":["string","null"]},"ip_address":{"description":"IP address of the target","type":["string","null"]},"is_ip":{"description":"indicates if the target is IP
if true, the domain, subdomain or webpage functions as an IP address and does not have a domain name","type":["boolean","null"]},"platform_type":{"description":"platform type","items":{"type":["string","null"]},"type":["array","null"]},"server":{"description":"server","type":["string","null"]},"target_spam_score":{"description":"spam score of the target
if the target is a domain/subdomain, this fields indicates the average spam score of all pages of that domain/subdomain;
learn more about how the metric is calculated on this help center page","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_TechnologiesInfo":{"properties":{"add_ons":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"analytics":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"booking":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"business_tools":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"communication":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"content":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"location":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"marketing":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"media":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"other":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"privacy":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"sales":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"security":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"servers":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"user_generated_content":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"utilities":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]},"web_development":{"additionalProperties":{"items":{"type":["string","null"]},"type":["array","null"]},"type":["object","null"]}},"type":"object"},"Response0A3E90081762_TechnologyCategoryInfo":{"properties":{"id":{"description":"id of the technology category
example:crm, cart_abandonment","type":["string","null"]},"path":{"description":"path to the technology category
example:user_generated_content.content_curation","type":["string","null"]},"technologies":{"description":"list of technologies in this category
example:\"Salesforce\", \"CareCart\"","items":{"type":["string","null"]},"type":["array","null"]},"title":{"description":"title of the technology category","type":["string","null"]}},"type":"object"},"Response0A3E90081762_TestSummary":{"properties":{"error":{"description":"number of serious microdata errors","type":["integer","null"]},"fatal":{"description":"number of fatal microdata errors","type":["integer","null"]},"info":{"description":"number of microdata information flags","type":["integer","null"]},"warning":{"description":"number of microdata warnings","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_ThirdPartyReviewsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"rating":{"description":"the element's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the number of reviews","format":"int64","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_TimeInfo":{"properties":{"hour":{"description":"hours in the 24-hour format","type":["integer","null"]},"minute":{"description":"minutes","type":["integer","null"]}},"type":"object"},"Response0A3E90081762_TopDomainInfo":{"properties":{"count":{"format":"int64","type":["integer","null"]},"domain":{"type":["string","null"]}}},"Response0A3E90081762_TopSightsElement":{"properties":{"description":{"description":"link description","type":["string","null"]},"rating":{"description":"the item's rating
the popularity rate based on reviews and displayed in SERP;
if there is none, equals null","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_TopSightsSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopSightsElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_TopStoriesElement":{"properties":{"amp_version":{"description":"Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version
Note: this check no longer appears in SERP","type":["boolean","null"]},"badges":{"description":"badges relevant to the element","items":{"type":["string","null"]},"type":["array","null"]},"date":{"description":"the date when the page source of the element was published","type":["string","null"]},"domain":{"description":"domain where a link points","type":["string","null"]},"image_url":{"description":"URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available)","type":["string","null"]},"source":{"description":"reference source name or title","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_TopStoriesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TopStoriesElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_TopicInfo":{"properties":{"author":{"description":"content author name
","type":["string","null"]},"h_title":{"description":"meta title
","type":["string","null"]},"language":{"description":"content language
","type":["string","null"]},"level":{"description":"HTML level
","type":["integer","null"]},"main_title":{"description":" main title of the block
","type":["string","null"]},"primary_content":{"description":"primary content on the page
you can find more information about content priority calculation in this help center article
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SectionContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"secondary_content":{"description":"secondary content on the page
you can find more information about content priority calculation in this help center article
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_SectionContentItemInfo"}],"type":["object","null"]},"type":["array","null"]},"table_content":{"description":"content of the table on the page
","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TableContentInfo"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_TrendsGraphDataInfo":{"properties":{"date_from":{"description":"start date of the corresponding time range
in the UTC format: \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"end date of the corresponding time range
in the UTC format: \"yyyy-mm-dd\"","type":["string","null"]},"missing_data":{"description":"indicates whether the data is unavailable
if true the data on the graph in the Google Trends interface is missing and thus labelled with a dotted line","type":["boolean","null"]},"timestamp":{"description":"a point in time in the Unix time format","type":["integer","null"]},"values":{"description":"relative keyword popularity rate at a specific timestamp
represents the keyword popularity rate over the given time range
if you specify more than one keyword, the values will be averaged to the highest value across all specified keywords
a value of 100 is the peak popularity for the term. A value of 50 means that the term is half as popular. A score of 0 means there was not enough data for this term","items":{"type":["number","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_TrendsMapDataInfo":{"properties":{"geo_id":{"description":"Google Trends location identifier
you can use this field for matching obtained results with location parameters specified in the request
example:US-NY","type":["string","null"]},"geo_name":{"description":"Google Trends location name
you can use this field for matching obtained results with location parameters specified in the request","type":["string","null"]},"max_value_index":{"description":"max value among comparable terms
represents the maximum value if you specified more than two keywords in a POST array
if you specified only one keyword, the value will be null","type":["integer","null"]},"values":{"description":"relative keyword popularity rate in a given location
represents the location-specific keyword popularity rate over the given time range
if you specify more than one keyword, the values will be averaged to the highest value across all specified keywords
a value of 100 is the peak popularity for the term
a value of 50 means that the term is half as popular
a value of 0 means there was not enough data for this term","items":{"type":["number","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_TripadvisorReviewSearch":{"properties":{"date_of_visit":{"description":"date of the reviewer's visit to the local establishment
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"language":{"description":"language of the review text","type":["string","null"]},"original_language":{"description":"language of the untranslated review text","type":["string","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: right","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"responses":{"description":"contains information about the owner's response","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ReviewResponseItemInfo"}],"type":["object","null"]},"type":["array","null"]},"review_highlights":{"description":"review highlights
contains highlighted review criteria and assessments","type":["object","null"]},"review_id":{"description":"ID of the review","type":["string","null"]},"review_images":{"description":"contains URLs of the images used in the review","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ImageUrlInfo"}],"type":["object","null"]},"type":["array","null"]},"review_text":{"description":"content of the review","type":["string","null"]},"timestamp":{"description":"date and time when the review was published
in the UTC format: \"yyyy-mm-dd hh-mm-ss +00:00\"
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the review","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of the review","type":["string","null"]},"user_profile":{"description":"information from the reviewer's profile","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataUserProfileInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_TripadvisorSearchOrganic":{"properties":{"category":{"description":"place category","type":["string","null"]},"is_sponsored":{"description":"indicates a sponsored placement
if true, related tripadvisor_search_organic item is a paid advertising on Tripadvisor","type":["boolean","null"]},"price_rate":{"description":"average price rate","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed results
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score of the establishment submitted by the reviewers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["integer","null"]},"title":{"description":"name of the business entity","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url_path":{"description":"URL path of the business entity
URL path to the Tripadvisor page of the business entity
you can use this identifier to collect reviews for the business entity using Tripadvisor Reviews","type":["string","null"]}},"type":"object"},"Response0A3E90081762_TrustpilotReviewSearch":{"properties":{"language":{"description":"the language of the review","type":["string","null"]},"position":{"description":"the alignment of the review in SERP
can take the following values: right","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score submitted by the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"responses":{"description":"owner's response to the submitted review","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ReviewResponseItemInfo"}],"type":["object","null"]},"type":["array","null"]},"review_images":{"description":"images submitted by the reviewer
displays URLs to the images provided by the author of the review;
please note that Trustpilot doesn't allow adding images to reviews, so the review_images parameter will always equal null","items":{"type":"string"},"type":["array","null"]},"review_text":{"description":"the content of the review","type":["string","null"]},"timestamp":{"description":"date and time when a review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"the title of the review","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"the URL of the review","type":["string","null"]},"user_profile":{"description":"user profile of the reviewer","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BusinessDataUserProfileInfo"}],"type":["object","null"]},"verified":{"description":"indicates whether the review has the \"Verified\" mark","type":["boolean","null"]}},"type":"object"},"Response0A3E90081762_TrustpilotSearchOrganic":{"properties":{"domain":{"description":"domain of the establishment","type":["string","null"]},"rank_absolute":{"description":"absolute rank among all the listed reviews
absolute position among all reviews on the list","type":["integer","null"]},"rank_group":{"description":"position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"rating":{"description":"the rating score of the establishment submitted by reviewers","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_RatingInfo"}],"type":["object","null"]},"reviews_count":{"description":"the total number of reviews","format":"int64","type":["integer","null"]},"title":{"description":"title of the establishment","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL to the establishment","type":["string","null"]}},"type":"object"},"Response0A3E90081762_TwitterElement":{"properties":{"date":{"description":"the date when the page source of the element was published","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"tweet":{"description":"tweet message","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_TwitterSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TwitterElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]},"title":{"description":"title of the row","type":["string","null"]},"url":{"description":"URL of the third-party review source","type":["string","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_UncrawlableResourcesMeta":{"properties":{"content_type":{"description":"actual content type of the resource","type":["string","null"]},"expected_content_types":{"description":"expected content types for the resource
list of content types that were expected by the crawler based on how the resource is referenced on the page","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"},"Response0A3E90081762_UserProfileInfo":{"properties":{"avatar":{"type":["string","null"]},"locations":{"type":["string","null"]},"name":{"type":["string","null"]},"reviews_count":{"format":"int64","type":["integer","null"]},"url":{"description":"relevant url","type":["string","null"]}},"type":"object"},"Response0A3E90081762_VideoElement":{"properties":{"preview":{"description":"URL to the video preview image","type":["string","null"]},"source":{"description":"URL to the video source","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of a given link element","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"source URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_VideoSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_VideoElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP
absolute position among all the elements in SERP
always equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values;
positions of elements with different type values are omitted from rank_group;
always equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"type":"object"},"Response0A3E90081762_VisualStoriesSerpElementItem":{"allOf":[{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_BaseSerpApiElementItem"}],"type":["object","null"]},{"properties":{"items":{"description":"contains arrays of elements available in the list","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AmazonLabelElement"}],"type":["object","null"]},"type":["array","null"]},"rank_absolute":{"description":"absolute rank in SERP\nabsolute position among all the elements in SERP\nalways equals 0 for desktop","type":["integer","null"]},"rank_group":{"description":"group rank in SERP\nposition within a group of elements with identical type values;\npositions of elements with different type values are omitted from rank_group;\nalways equals 0 for desktop","type":["integer","null"]}},"type":"object"}],"deprecated":true,"type":"object"},"Response0A3E90081762_WaterfallResourceInfo":{"properties":{"duration_time":{"description":"total time it takes until a browser receives a complete response from a server (in milliseconds)","type":["integer","null"]},"fetch_end":{"description":"time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page","type":["integer","null"]},"fetch_start":{"description":"time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page","type":["integer","null"]},"initiator":{"description":"resource initiator","type":["string","null"]},"is_render_blocking":{"description":"indicates whether the resource blocks rendering","type":["boolean","null"]},"location":{"description":"location of the resource in the document
parameters defining the location of the specific resource within the document's HTML","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_OnPageResourceLocationInfo"}],"type":["object","null"]},"resource_type":{"type":["string","null"]},"url":{"description":"resource URL","type":["string","null"]}},"type":"object"},"Response0A3E90081762_WorkDayInfo":{"properties":{"close":{"description":"closing time","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TimeInfo"}],"type":["object","null"]},"open":{"description":"opening time","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_TimeInfo"}],"type":["object","null"]}},"type":"object"},"Response0A3E90081762_WorkHours":{"properties":{"current_status":{"description":"current status of the establishment
indicates whether the establishment is opened or closed","type":["string","null"]},"timetable":{"additionalProperties":{"items":{"description":"work hours on Sundays","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_WorkDayInfo"}],"type":["object","null"]},"type":["array","null"]},"description":"work hours timetable","type":["object","null"]}},"type":"object"},"Response0A3E90081762_YoutubeComment":{"properties":{"author_name":{"description":"name of the author of the comment","type":["string","null"]},"author_thumbnail":{"description":"the URL of the page where the author's channel logo is hosted","type":["string","null"]},"author_url":{"description":"URL of the author's channel","type":["string","null"]},"likes_count":{"description":"number of likes on the comment","format":"int64","type":["integer","null"]},"publication_date":{"description":"displayed publication date","type":["string","null"]},"rank_absolute":{"description":" absolute rank in SERP for the target domain
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"reply_count":{"description":"number of replies on the comment","format":"int64","type":["integer","null"]},"text":{"description":"text of the comment","type":["string","null"]},"timestamp":{"description":"date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-11-15 12:57:46 +00:00","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_YoutubeSubtitles":{"properties":{"duration_time":{"description":"duration of subtitles in seconds","type":["number","null"]},"end_time":{"description":"the second subtitled text ends","type":["number","null"]},"rank_absolute":{"description":" absolute rank in SERP for the target domain
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"start_time":{"description":"the second subtitled text starts","type":["number","null"]},"text":{"description":"text translated in subtitles","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]}},"type":"object"},"Response0A3E90081762_YoutubeVideoInfo":{"properties":{"category":{"description":"the category the video belongs to","type":["string","null"]},"channel_id":{"description":"the ID of the channel where the video is published","type":["string","null"]},"channel_logo":{"description":"the URL of the page where the logo image of the channel is hosted","type":["string","null"]},"channel_name":{"description":"the name of the channel where the video is published","type":["string","null"]},"channel_subscribers_count":{"description":"number of subscribers of the channel","oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_ChannelSubscribersCount"}],"type":["object","null"]},"channel_url":{"description":"the URL of the channel where the video is published","type":["string","null"]},"comments_count":{"description":"number of comments on the video","format":"int64","type":["integer","null"]},"description":{"description":"description of the video","type":["string","null"]},"duration_time":{"description":"duration of the video","type":["string","null"]},"duration_time_seconds":{"description":"duration of the video in seconds","type":["integer","null"]},"is_embeddable":{"description":"indicates whether the video is embeddable","type":["boolean","null"]},"is_live":{"description":"indicates whether the video is on live","type":["boolean","null"]},"keywords":{"description":"keywords relevant to the video
also known as 'YouTube tags'","items":{"type":["string","null"]},"type":["array","null"]},"likes_count":{"description":"number of likes on the video","format":"int64","type":["integer","null"]},"publication_date":{"description":"the date when the video is published","type":["string","null"]},"rank_absolute":{"description":" absolute rank in SERP for the target domain
absolute position among all the elements in SERP","type":["integer","null"]},"rank_group":{"description":"group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group","type":["integer","null"]},"streaming_quality":{"description":"array of elements that contain information about all possible streaming qualities of the video","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_StreamingQualityElement"}],"type":["object","null"]},"type":["array","null"]},"subtitles":{"description":"array of elements describing properties of subtitles in the video","items":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_Subtitles"}],"type":["object","null"]},"type":["array","null"]},"thumbnail_url":{"description":"the URL of the page where the thumbnail is hosted","type":["string","null"]},"timestamp":{"description":"date and time when the result is published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2022-11-15 12:57:46 +00:00","type":["string","null"]},"title":{"description":"title of the video","type":["string","null"]},"type":{"description":"type of element","type":["string","null"]},"url":{"description":"URL of the video","type":["string","null"]},"video_id":{"description":"ID of the video received in a POST array","type":["string","null"]},"views_count":{"description":"number of views of the video","format":"int64","type":["integer","null"]}},"type":"object"},"Response0Cee89220B8F_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response0D1E98E052C3_Trend":{"properties":{"meta_description":{"type":"string"},"name":{"type":"string"},"rank":{"format":"int64","type":"integer"},"target":{"properties":{"query":{"type":"string"}},"type":"object"}},"type":"object"},"Response0D1E98E052C3_TrendsResponse":{"properties":{"msg":{"type":"string"},"status":{"enum":["success","error"],"type":"string"},"trends":{"items":{"$ref":"#/components/schemas/Response0D1E98E052C3_Trend"},"type":"array"}},"type":"object"},"Response10C6522D345B_IndustrySearchResult":{"properties":{"code":{"description":"Unique industry code.","type":"string"},"industry_name":{"description":"Full name of the industry.","type":"string"},"similarity":{"description":"Similarity score between the query and the matched industry, ranging from 0 to 1. Higher values indicate a closer match.","format":"float","type":"number"}},"type":"object"},"Response1Fc51B60A782_ResponseModel":{"properties":{"cache_message":{"default":"This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.","description":"Cache message (EN-US)","title":"Cache Message","type":["string","null"]},"cache_message_zh":{"default":"本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。","description":"Cache message (ZH-CN)","title":"Cache Message Zh","type":["string","null"]},"cache_url":{"description":"The URL to access the cached result","title":"Cache Url","type":["string","null"]},"code":{"default":200,"description":"HTTP status code","title":"Code","type":"integer"},"data":{"description":"Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.","title":"Data"},"docs":{"description":"Link to the API Swagger documentation for this endpoint","title":"Docs","type":["string","null"]},"message":{"default":"Request successful. This request will incur a charge.","description":"Response message (EN-US)","title":"Message","type":"string"},"message_zh":{"default":"请求成功，本次请求将被计费。","description":"Response message (ZH-CN)","title":"Message Zh","type":"string"},"params":{"default":{},"description":"The parameters used in the request","title":"Params"},"request_id":{"description":"Unique request identifier","title":"Request Id","type":["string","null"]},"router":{"default":"","description":"The endpoint that generated this response","title":"Router","type":"string"},"support":{"default":"Discord: https://discord.gg/aMEAS8Xsvz","description":"Support message","title":"Support","type":"string"},"time":{"description":"The time the response was generated","title":"Time","type":"string"},"time_stamp":{"description":"The timestamp the response was generated","title":"Time Stamp","type":"integer"},"time_zone":{"default":"America/Los_Angeles","description":"The timezone of the response time","title":"Time Zone","type":"string"}},"title":"ResponseModel","type":"object"},"Response26Fec513Ccb9_StatusDetail":{"description":"Request-type-specific details for company_addition request.","properties":{"company_addition_request_id":{"description":"Identifier of the underlying request record.","type":"string"},"company_name":{"description":"Name of the company submitted for addition.","type":"string"},"company_uuid":{"description":"Akta UUID of the company once it has been added. null until the request is completed.","type":["string","null"]},"created_at":{"description":"Timestamp when the underlying request was created, in ISO 8601 format.","type":"string"},"domain":{"description":"Resolved domain of the submitted company.","type":"string"},"reason":{"description":"Explanation when the request did not succeed. null unless the request has failed.","type":["string","null"]},"status":{"description":"Status of the underlying request. Possible values: pending, in_progress, completed, failed.","type":"string"},"updated_at":{"description":"Timestamp when the underlying request was last updated, in ISO 8601 format.","type":"string"}},"type":"object"},"Response26Fec513Ccb9_StatusResponse":{"properties":{"created_at":{"description":"Timestamp when the request was created, in ISO 8601 format.","type":"string"},"detail":{"$ref":"#/components/schemas/Response26Fec513Ccb9_StatusDetail"},"request_id":{"description":"Unique identifier of the request being tracked.","type":"string"},"request_type":{"description":"The type of request. Example: company_addition","type":"string"},"status":{"description":"Current status of the request. Possible values: pending, in_progress, completed, failed.","type":"string"},"updated_at":{"description":"Timestamp when the request was last updated, in ISO 8601 format.","type":"string"}},"type":"object"},"Response35F4A4Efeaa1_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response3716D452B70B_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response38395Bb200C1_type_metrics_MetricBucket":{"properties":{"count":{"description":"Count of events in the bucket.","type":"integer"},"timestamp":{"description":"Timestamp of the bucket.","format":"date-time","type":"string"}},"required":["timestamp","count"],"title":"MetricBucket","type":"object"},"Response38395Bb200C1_type_metrics_QueryMetricsResponse":{"additionalProperties":{"items":{"$ref":"#/components/schemas/Response38395Bb200C1_type_metrics_MetricBucket"},"type":"array"},"description":"Metrics grouped by event type.","title":"QueryMetricsResponse","type":"object"},"Response3F1A62754080_Address":{"description":"Ethereum address (0x-prefixed, 40 hex chars)","example":"0x6e0c80c90ea6c15917308F820Eac91Ce2724B5b5","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"Response3F1A62754080_DeployedResponse":{"properties":{"deployed":{"description":"Whether the wallet is deployed","example":true,"type":"boolean"}},"type":"object"},"Response3F1A62754080_NonceResponse":{"properties":{"nonce":{"description":"Current nonce value","example":"31","type":"string"}},"type":"object"},"Response3F1A62754080_RelayPayloadResponse":{"properties":{"address":{"$ref":"#/components/schemas/Response3F1A62754080_Address"},"nonce":{"description":"Current nonce value","example":"31","type":"string"}},"type":"object"},"Response3F1A62754080_RelayerTransaction":{"properties":{"createdAt":{"description":"Timestamp when the transaction was created","example":"2024-07-14T21:13:08.819782Z","format":"date-time","type":"string"},"data":{"description":"Encoded transaction data (0x-prefixed hex string)","example":"0x...","type":"string"},"from":{"$ref":"#/components/schemas/Response3F1A62754080_Address"},"metadata":{"description":"Transaction metadata","example":"","type":"string"},"nonce":{"description":"Transaction nonce","example":"60","type":"string"},"owner":{"$ref":"#/components/schemas/Response3F1A62754080_Address"},"proxyAddress":{"$ref":"#/components/schemas/Response3F1A62754080_Address"},"signature":{"description":"Transaction signature (0x-prefixed hex string)","example":"0x01a060c734d7bdf4adde50c4a7e574036b1f8b12890911bdd1c1cfdcd77502381b89fa8a47c36f62a0b9f1cdfee7b260fd8108536db9f6b2089c02637e7de9fc20","type":"string"},"state":{"description":"Current state of the transaction","enum":["STATE_NEW","STATE_EXECUTED","STATE_MINED","STATE_CONFIRMED","STATE_INVALID","STATE_FAILED"],"example":"STATE_CONFIRMED","type":"string"},"to":{"$ref":"#/components/schemas/Response3F1A62754080_Address"},"transactionHash":{"description":"Onchain transaction hash (available once confirmed)","example":"0x38cbfbeae8fffa4e2b187ee5978d3ee9cafc53af0363ed90a35b7ea9016535d8","type":"string"},"transactionID":{"description":"Unique identifier for the transaction","example":"0190b317-a1d3-7bec-9b91-eeb6dcd3a620","type":"string"},"type":{"description":"Transaction type","enum":["SAFE","PROXY"],"example":"SAFE","type":"string"},"updatedAt":{"description":"Timestamp when the transaction was last updated","example":"2024-07-14T21:13:46.576639Z","format":"date-time","type":"string"},"value":{"description":"Transaction value","example":"","type":"string"}},"type":"object"},"Response4Efd2D7Df89E_BookSide":{"description":"Side of the book for an order or trade. For event markets, this refers to the YES leg only: `bid` means buy YES, `ask` means sell YES. (Selling YES is economically equivalent to buying NO at `1 - price`, but this endpoint quotes everything from the YES side.)","enum":["bid","ask"],"type":"string"},"Response4Efd2D7Df89E_ExchangeIndex":{"description":"Identifier for an exchange shard.","example":0,"type":"integer"},"Response4Efd2D7Df89E_FixedPointCount":{"description":"Fixed-point contract count string (2 decimals, e.g., \"10.00\"; referred to as \"fp\" in field names). Requests accept 0-2 decimal places (e.g., \"10\", \"10.0\", \"10.00\"); responses always emit 2 decimals. Fractional contract values (e.g., \"2.50\") are supported; the minimum granularity is 0.01 contracts.","example":"10.00","type":"string"},"Response4Efd2D7Df89E_FixedPointDollars":{"description":"Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., \"0.56\", \"0.5600\"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.","example":"0.5600","type":"string"},"Response4Efd2D7Df89E_GetMarketOrderbookResponse":{"properties":{"orderbook_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_OrderbookCountFp"}},"required":["orderbook_fp"],"type":"object"},"Response4Efd2D7Df89E_GetMarketResponse":{"properties":{"market":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_Market"}},"required":["market"],"type":"object"},"Response4Efd2D7Df89E_GetMarketsResponse":{"properties":{"cursor":{"type":"string"},"markets":{"items":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_Market"},"type":"array"}},"required":["markets","cursor"],"type":"object"},"Response4Efd2D7Df89E_GetTradesResponse":{"properties":{"cursor":{"type":"string"},"trades":{"items":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_Trade"},"type":"array"}},"required":["trades","cursor"],"type":"object"},"Response4Efd2D7Df89E_Market":{"properties":{"can_close_early":{"type":"boolean"},"cap_strike":{"description":"Maximum expiration value that leads to a YES settlement","format":"double","type":["number","null"],"x-omitempty":true},"close_time":{"format":"date-time","type":"string"},"created_time":{"format":"date-time","type":"string"},"custom_strike":{"description":"Expiration value for each target that leads to a YES settlement","type":["object","null"],"x-omitempty":true},"early_close_condition":{"description":"The condition under which the market can close early","type":["string","null"],"x-go-type-skip-optional-pointer":true,"x-omitempty":true},"event_ticker":{"type":"string"},"exchange_index":{"allOf":[{"$ref":"#/components/schemas/Response4Efd2D7Df89E_ExchangeIndex"}],"x-go-type-skip-optional-pointer":true,"x-omitempty":false},"expected_expiration_time":{"description":"Time when this market is expected to expire","format":"date-time","type":["string","null"],"x-omitempty":true},"expiration_time":{"deprecated":true,"format":"date-time","type":"string","x-go-type-skip-optional-pointer":true},"expiration_value":{"description":"The value that was considered for the settlement","type":"string"},"fee_waiver_expiration_time":{"description":"Time when this market's fee waiver expires","format":"date-time","type":["string","null"],"x-omitempty":true},"floor_strike":{"description":"Minimum expiration value that leads to a YES settlement","format":"double","type":["number","null"],"x-omitempty":true},"functional_strike":{"description":"Mapping from expiration values to settlement values","type":["string","null"],"x-omitempty":true},"is_provisional":{"description":"If true, the market may be removed after determination if there is no activity on it","type":"boolean","x-go-type-skip-optional-pointer":true,"x-omitempty":true},"last_price_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"latest_expiration_time":{"description":"Latest possible time for this market to expire","format":"date-time","type":"string"},"market_type":{"description":"Identifies the type of market","enum":["binary","scalar"],"type":"string"},"mve_collection_ticker":{"description":"The ticker of the multivariate event collection","type":"string","x-go-type-skip-optional-pointer":true,"x-omitempty":true},"mve_selected_legs":{"items":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_MveSelectedLeg"},"type":"array","x-go-type-skip-optional-pointer":true,"x-omitempty":true},"no_ask_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"no_bid_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"no_sub_title":{"description":"Shortened title for the no side of this market","type":"string"},"notional_value_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"occurrence_datetime":{"description":"The recorded datetime when the underlying event occurred, if available","format":"date-time","type":["string","null"]},"open_interest_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointCount"},"open_time":{"format":"date-time","type":"string"},"previous_price_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"previous_yes_ask_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"previous_yes_bid_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"price_level_structure":{"description":"Price level structure for this market, defining price ranges and tick sizes","type":"string"},"price_ranges":{"description":"Valid price ranges for orders on this market","items":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_PriceRange"},"type":"array"},"primary_participant_key":{"type":["string","null"],"x-omitempty":true},"result":{"enum":["yes","no","scalar",""],"type":"string"},"rules_primary":{"description":"A plain language description of the most important market terms","type":"string"},"rules_secondary":{"description":"A plain language description of secondary market terms","type":"string"},"settlement_bounds_type":{"description":"Which settlement bounds apply to this market. default means the market has no settlement bounds","enum":["default","floor"],"type":"string"},"settlement_floor_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"settlement_timer_seconds":{"description":"The amount of time after determination that the market settles","type":"integer"},"settlement_ts":{"description":"Timestamp when the market was settled. Only filled for settled markets","format":"date-time","type":["string","null"],"x-omitempty":true},"settlement_value_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"status":{"description":"The current status of the market in its lifecycle.","enum":["initialized","inactive","active","closed","determined","disputed","amended","finalized"],"type":"string"},"strike_type":{"description":"Strike type defines how the market strike is defined and evaluated","enum":["greater","greater_or_equal","less","less_or_equal","between","functional","custom","structured"],"type":"string","x-go-type-skip-optional-pointer":true,"x-omitempty":true},"subtitle":{"deprecated":true,"type":"string","x-go-type-skip-optional-pointer":true},"ticker":{"type":"string"},"title":{"deprecated":true,"type":"string","x-go-type-skip-optional-pointer":true},"updated_time":{"description":"Time of the last non-trading metadata update.","format":"date-time","type":"string"},"volume_24h_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointCount"},"volume_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointCount"},"yes_ask_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"yes_ask_size_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointCount"},"yes_bid_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"yes_bid_size_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointCount"},"yes_sub_title":{"description":"Shortened title for the yes side of this market","type":"string"}},"required":["ticker","event_ticker","market_type","yes_sub_title","no_sub_title","created_time","updated_time","open_time","close_time","latest_expiration_time","settlement_timer_seconds","status","notional_value_dollars","yes_bid_dollars","yes_ask_dollars","no_bid_dollars","no_ask_dollars","yes_bid_size_fp","yes_ask_size_fp","last_price_dollars","previous_yes_bid_dollars","previous_yes_ask_dollars","previous_price_dollars","volume_fp","volume_24h_fp","open_interest_fp","result","can_close_early","expiration_value","rules_primary","rules_secondary","price_level_structure","price_ranges","settlement_bounds_type"],"type":"object"},"Response4Efd2D7Df89E_MveSelectedLeg":{"properties":{"event_ticker":{"description":"Unique identifier for the selected event","type":"string","x-go-type-skip-optional-pointer":true},"market_ticker":{"description":"Unique identifier for the selected market","type":"string","x-go-type-skip-optional-pointer":true},"side":{"description":"The side of the selected market","type":"string","x-go-type-skip-optional-pointer":true},"yes_settlement_value_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"}},"type":"object"},"Response4Efd2D7Df89E_OrderbookCountFp":{"description":"Orderbook with fixed-point contract counts (fp) in all dollar price levels.","properties":{"no_dollars":{"items":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_PriceLevelDollarsCountFp"},"type":"array"},"yes_dollars":{"items":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_PriceLevelDollarsCountFp"},"type":"array"}},"required":["yes_dollars","no_dollars"],"type":"object"},"Response4Efd2D7Df89E_PriceLevelDollarsCountFp":{"description":"Price level in dollars represented as [dollars_string, fp] where dollars_string is like \"0.1500\" and fp is a FixedPointCount string (fixed-point contract count). The second element is the contract quantity (not price).","example":["0.1500","100.00"],"items":{"type":"string"},"maxItems":2,"minItems":2,"type":"array"},"Response4Efd2D7Df89E_PriceRange":{"properties":{"end":{"description":"Ending price for this range in dollars","type":"string"},"start":{"description":"Starting price for this range in dollars","type":"string"},"step":{"description":"Price step/tick size for this range in dollars","type":"string"}},"required":["start","end","step"],"type":"object"},"Response4Efd2D7Df89E_Trade":{"properties":{"count_fp":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointCount"},"created_time":{"description":"Timestamp when this trade was executed","format":"date-time","type":"string"},"is_block_trade":{"description":"True if this trade was matched off-book as a block trade (e.g. via RFQ / negotiated block proposal); false for trades that filled on the standard order book.","type":"boolean"},"no_price_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"},"taker_book_side":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_BookSide"},"taker_outcome_side":{"description":"The outcome side the taker is positioned for. buy-yes and sell-no produce 'yes'; buy-no and sell-yes produce 'no'.\n\n`taker_outcome_side` describes directional exposure only; it does not change the trade's price. A trade at price `p` with `taker_outcome_side=no` is matched against the maker at the same price `p` with the opposite direction — both parties trade at the same price.\n\n`taker_outcome_side` and `taker_book_side` will become the canonical way to determine trade direction. The legacy `taker_side` field will be deprecated in a future release — please migrate to these new fields.\n","enum":["yes","no"],"type":"string","x-enum-varnames":["TradeTakerOutcomeSideYes","TradeTakerOutcomeSideNo"]},"taker_side":{"deprecated":true,"description":"Deprecated. Use `taker_outcome_side` (or `taker_book_side`) instead. See [Order direction](/getting_started/order_direction). This field will not be removed before May 14, 2026.\n","enum":["yes","no"],"type":"string","x-enum-varnames":["TradeTakerSideYes","TradeTakerSideNo"],"x-go-type-skip-optional-pointer":true},"ticker":{"description":"Unique identifier for the market","type":"string"},"trade_id":{"description":"Unique identifier for this trade","type":"string"},"yes_price_dollars":{"$ref":"#/components/schemas/Response4Efd2D7Df89E_FixedPointDollars"}},"required":["trade_id","ticker","count_fp","yes_price_dollars","no_price_dollars","taker_outcome_side","taker_book_side","created_time","is_block_trade"],"type":"object"},"Response5186Bc180F5F_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response51Fe176F017A_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response62E957Bfd704_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response65D835437A58_Activity":{"properties":{"asset":{"description":"Token ID this row refers to. Populated on `REDEEM` rows with the token that row settles. Empty when the row is not token-specific.","type":"string"},"bio":{"type":"string"},"conditionId":{"$ref":"#/components/schemas/Response65D835437A58_Hash64"},"eventSlug":{"type":"string"},"icon":{"description":"Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own. Empty on `CONVERSION` rows.","type":"string"},"isCombo":{"description":"True when this row is part of a combinatorial (multi-market) position. Flag only — combo detail is not embedded here. The row's conditionId equals the combo's combo_condition_id; pass it to /v1/activity/combos or /v1/positions/combos via market_id to fetch legs and detail. Omitted on non-combo rows.","type":"boolean"},"name":{"type":"string"},"outcome":{"type":"string"},"outcomeIndex":{"description":"Zero-based index of this row's outcome in the market's `outcomes` array, so `outcome` always equals `outcomes[outcomeIndex]`. On `REDEEM` rows it identifies the outcome the row settles, not the market's winning outcome. `999` means the outcome could not be determined, in which case `outcome` is empty.","type":"integer"},"price":{"type":"number"},"profileImage":{"type":"string"},"profileImageOptimized":{"type":"string"},"proxyWallet":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"pseudonym":{"type":"string"},"side":{"enum":["BUY","SELL"],"type":"string"},"size":{"description":"Token amount for this row. On `REDEEM` rows it is the number of tokens burned for this row's outcome, so redeeming both sides of a market returns one row per outcome instead of a single combined row.","type":"number"},"slug":{"type":"string"},"timestamp":{"format":"int64","type":"integer"},"title":{"type":"string"},"transactionHash":{"type":"string"},"type":{"enum":["TRADE","SPLIT","MERGE","REDEEM","REWARD","CONVERSION","DEPOSIT","WITHDRAWAL","YIELD","MAKER_REBATE","TAKER_REBATE","REFERRAL_REWARD"],"type":"string"},"usdcSize":{"description":"USDC amount for this row. On `REDEEM` rows it is the payout for this row's outcome and is `0` for a losing outcome; the rows of one redemption sum to the total payout.","type":"number"}},"type":"object"},"Response65D835437A58_Address":{"description":"User Profile Address (0x-prefixed, 40 hex chars)","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"Response65D835437A58_BuilderVolumeEntry":{"properties":{"activeUsers":{"description":"Number of active users for this builder on this date","type":"integer"},"builder":{"description":"The builder name or identifier","type":"string"},"builderCode":{"description":"The builder's onchain attribution code as attached to orders via `builderCode` (see CLOB V2). Empty string for legacy builders without a registered code.","type":"string"},"builderLogo":{"description":"URL to the builder's logo image","type":"string"},"dt":{"description":"The timestamp for this volume entry in ISO 8601 format","example":"2025-11-15T00:00:00Z","format":"date-time","type":"string"},"rank":{"description":"The rank position of the builder on this date","type":"string"},"verified":{"description":"Whether the builder is verified","type":"boolean"},"volume":{"description":"Trading volume for this builder on this date","type":"number"}},"type":"object"},"Response65D835437A58_ClosedPosition":{"properties":{"asset":{"type":"string"},"avgPrice":{"type":"number"},"conditionId":{"$ref":"#/components/schemas/Response65D835437A58_Hash64"},"curPrice":{"type":"number"},"endDate":{"type":"string"},"eventSlug":{"type":"string"},"icon":{"type":"string"},"oppositeAsset":{"type":"string"},"oppositeOutcome":{"type":"string"},"outcome":{"type":"string"},"outcomeIndex":{"type":"integer"},"proxyWallet":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"realizedPnl":{"type":"number"},"slug":{"type":"string"},"timestamp":{"format":"int64","type":"integer"},"title":{"type":"string"},"totalBought":{"type":"number"}},"type":"object"},"Response65D835437A58_Hash64":{"description":"0x-prefixed 64-hex string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"Response65D835437A58_Holder":{"properties":{"amount":{"type":"number"},"asset":{"type":"string"},"bio":{"type":"string"},"displayUsernamePublic":{"type":"boolean"},"name":{"type":"string"},"outcomeIndex":{"type":"integer"},"profileImage":{"type":"string"},"profileImageOptimized":{"type":"string"},"proxyWallet":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"pseudonym":{"type":"string"}},"type":"object"},"Response65D835437A58_LeaderboardEntry":{"properties":{"activeUsers":{"description":"Number of active users for this builder","type":"integer"},"builder":{"description":"The builder name or identifier","type":"string"},"builderCode":{"description":"The builder's onchain attribution code as attached to orders via `builderCode` (see CLOB V2). Empty string for legacy builders without a registered code.","type":"string"},"builderLogo":{"description":"URL to the builder's logo image","type":"string"},"rank":{"description":"The rank position of the builder","type":"string"},"verified":{"description":"Whether the builder is verified","type":"boolean"},"volume":{"description":"Total trading volume attributed to this builder","type":"number"}},"type":"object"},"Response65D835437A58_LiveVolume":{"properties":{"markets":{"items":{"$ref":"#/components/schemas/Response65D835437A58_MarketVolume"},"type":"array"},"total":{"type":"number"}},"type":"object"},"Response65D835437A58_MarketPositionV1":{"properties":{"asset":{"type":"string"},"avgPrice":{"type":"number"},"cashPnl":{"type":"number"},"conditionId":{"$ref":"#/components/schemas/Response65D835437A58_Hash64"},"currPrice":{"type":"number"},"currentValue":{"type":"number"},"name":{"type":"string"},"outcome":{"type":"string"},"outcomeIndex":{"type":"integer"},"profileImage":{"type":"string"},"proxyWallet":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"realizedPnl":{"type":"number"},"size":{"type":"number"},"totalBought":{"type":"number"},"totalPnl":{"type":"number"},"verified":{"type":"boolean"}},"type":"object"},"Response65D835437A58_MarketVolume":{"properties":{"market":{"$ref":"#/components/schemas/Response65D835437A58_Hash64"},"value":{"type":"number"}},"type":"object"},"Response65D835437A58_MetaHolder":{"properties":{"holders":{"items":{"$ref":"#/components/schemas/Response65D835437A58_Holder"},"type":"array"},"token":{"type":"string"}},"type":"object"},"Response65D835437A58_MetaMarketPositionV1":{"properties":{"positions":{"items":{"$ref":"#/components/schemas/Response65D835437A58_MarketPositionV1"},"type":"array"},"token":{"description":"The outcome token asset ID","type":"string"}},"type":"object"},"Response65D835437A58_OpenInterest":{"properties":{"market":{"$ref":"#/components/schemas/Response65D835437A58_Hash64"},"value":{"type":"number"}},"type":"object"},"Response65D835437A58_Position":{"properties":{"asset":{"type":"string"},"avgPrice":{"type":"number"},"cashPnl":{"type":"number"},"conditionId":{"$ref":"#/components/schemas/Response65D835437A58_Hash64"},"curPrice":{"type":"number"},"currentValue":{"type":"number"},"endDate":{"type":"string"},"entryFeesUsdc":{"description":"Attributed BUY-fee component of `grossInitialValue`, at six-decimal source precision. SELL fees are exit costs and are never included. Returned as an explicit `0` when the fee component is zero. Optional: treat an omitted field as unavailable rather than as zero.","type":"number"},"eventSlug":{"type":"string"},"grossInitialValue":{"description":"Remaining entry basis including attributed BUY fees, at six-decimal source precision. `initialValue` and `avgPrice` keep their fee-exclusive semantics, so the fee-exclusive basis is `grossInitialValue - entryFeesUsdc`. Optional: treat an omitted field as unavailable rather than as zero.","type":"number"},"icon":{"type":"string"},"initialValue":{"type":"number"},"mergeable":{"type":"boolean"},"negativeRisk":{"type":"boolean"},"oppositeAsset":{"type":"string"},"oppositeOutcome":{"type":"string"},"outcome":{"type":"string"},"outcomeIndex":{"type":"integer"},"percentPnl":{"type":"number"},"percentRealizedPnl":{"type":"number"},"proxyWallet":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"realizedPnl":{"type":"number"},"redeemable":{"type":"boolean"},"size":{"type":"number"},"slug":{"type":"string"},"title":{"type":"string"},"totalBought":{"type":"number"}},"type":"object"},"Response65D835437A58_Traded":{"properties":{"traded":{"type":"integer"},"user":{"$ref":"#/components/schemas/Response65D835437A58_Address"}},"type":"object"},"Response65D835437A58_TraderLeaderboardEntry":{"properties":{"pnl":{"description":"Profit and loss for this trader","type":"number"},"profileImage":{"description":"URL to the trader's profile image","type":"string"},"proxyWallet":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"rank":{"description":"The rank position of the trader","type":"string"},"userName":{"description":"The trader's username","type":"string"},"verifiedBadge":{"description":"Whether the trader has a verified badge","type":"boolean"},"vol":{"description":"Trading volume for this trader","type":"number"},"xUsername":{"description":"The trader's X (Twitter) username","type":"string"}},"type":"object"},"Response65D835437A58_Value":{"properties":{"user":{"$ref":"#/components/schemas/Response65D835437A58_Address"},"value":{"type":"number"}},"type":"object"},"Response68C5148660B1_AssetEarning":{"description":"Earnings for a specific asset","properties":{"asset_address":{"description":"Address of the reward asset","type":"string"},"asset_rate":{"description":"Exchange rate of the asset","format":"double","type":"number"},"earnings":{"description":"Amount of earnings","format":"double","type":"number"}},"required":["asset_address","earnings"],"type":"object"},"Response68C5148660B1_BatchPricesHistoryResponse":{"properties":{"history":{"additionalProperties":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_MarketPrice"},"type":"array"},"description":"Map of market asset id to array of price data points.","type":"object"}},"type":"object"},"Response68C5148660B1_BuilderTrade":{"description":"Builder trade information","properties":{"assetId":{"description":"Asset ID (token ID)","example":"15871154585880608648532107628464183779895785213830018178010423617714102767076","type":"string"},"bucketIndex":{"description":"Bucket index","example":0,"type":"integer"},"builder":{"description":"Builder code attributed to the trade","example":"0x0000000000000000000000000000000000000000000000000000000000000001","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"createdAt":{"description":"Creation timestamp","example":"2024-01-01T00:00:00Z","format":"date-time","type":"string"},"err_msg":{"description":"Error message (if any)","example":null,"type":["string","null"]},"fee":{"description":"Fee amount","example":"300000","type":"string"},"feeUsdc":{"description":"Fee amount in USDC","example":"150000","type":"string"},"id":{"description":"Trade ID","example":"trade-123","type":"string"},"maker":{"description":"Maker address","example":"0x1234567890123456789012345678901234567890","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"market":{"description":"Market (condition ID)","example":"0x0000000000000000000000000000000000000000000000000000000000000001","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"matchTime":{"description":"Match time (Unix timestamp)","example":"1700000000","type":"string"},"outcome":{"description":"Market outcome","example":"YES","type":"string"},"outcomeIndex":{"description":"Outcome index","example":0,"type":"integer"},"owner":{"description":"Owner UUID","example":"f4f247b7-4ac7-ff29-a152-04fda0a8755a","type":"string"},"price":{"description":"Trade price","example":"0.5","type":"string"},"side":{"description":"Trade side","enum":["BUY","SELL"],"example":"BUY","type":"string"},"size":{"description":"Trade size","example":"100000000","type":"string"},"sizeUsdc":{"description":"Trade size in USDC","example":"50000000","type":"string"},"status":{"description":"Trade status","example":"TRADE_STATUS_CONFIRMED","type":"string"},"takerOrderHash":{"description":"Taker order hash","example":"0xabcdef1234567890abcdef1234567890abcdef12","type":"string"},"tradeType":{"description":"Trade type","example":"TAKER","type":"string"},"transactionHash":{"description":"Transaction hash","example":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"updatedAt":{"description":"Last update timestamp","example":"2024-01-01T00:00:00Z","format":"date-time","type":"string"}},"required":["id","tradeType","takerOrderHash","builder","market","assetId","side","size","sizeUsdc","price","status","outcome","outcomeIndex","owner","maker","transactionHash","matchTime","bucketIndex","fee","feeUsdc"],"type":"object"},"Response68C5148660B1_BuilderTradesResponse":{"description":"Paginated builder trades response","properties":{"count":{"description":"Number of items in current response","example":2,"type":"integer"},"data":{"description":"Array of builder trades","items":{"$ref":"#/components/schemas/Response68C5148660B1_BuilderTrade"},"type":"array"},"limit":{"description":"Maximum number of items per page","example":300,"type":"integer"},"next_cursor":{"description":"Cursor for next page (base64 encoded offset). \"LTE=\" indicates no more pages","example":"MzAw","type":"string"}},"required":["limit","next_cursor","count","data"],"type":"object"},"Response68C5148660B1_CancelOrdersResponse":{"properties":{"canceled":{"description":"Array of order IDs that were successfully canceled","example":["0xabcdef1234567890abcdef1234567890abcdef12"],"items":{"type":"string"},"type":"array"},"not_canceled":{"additionalProperties":{"type":"string"},"description":"Map of order IDs that could not be canceled with error messages","example":{"0xabcdef1234567890abcdef1234567890abcdef12":"Order not found or already canceled"},"type":"object"}},"required":["canceled","not_canceled"],"type":"object"},"Response68C5148660B1_ClobMarketDetails":{"description":"CLOB-level parameters for a market — tokens, tick size, base fees, rewards, RFQ status, and fee details.","properties":{"fd":{"$ref":"#/components/schemas/Response68C5148660B1_FeeDetails"},"gst":{"description":"Game start time (used for sports markets), ISO 8601 timestamp or null","format":"date-time","nullable":true,"type":"string"},"ibce":{"description":"Whether Blockaid check is enabled","type":"boolean"},"itode":{"description":"Whether taker order delay is enabled for this market. When true, marketable orders are held for the 250 ms taker-delay window before synchronous processing. This field is omitted when false.","type":"boolean"},"mbf":{"description":"Maker base fee in basis points","example":0,"format":"int64","type":"integer"},"mos":{"description":"Minimum order size","example":5,"format":"float","type":"number"},"mts":{"description":"Minimum tick size (price increment)","example":0.01,"format":"float","type":"number"},"oas":{"description":"Minimum order age in seconds","type":"integer"},"r":{"$ref":"#/components/schemas/Response68C5148660B1_ClobRewards"},"rfqe":{"description":"Whether RFQ (Request for Quote) is enabled for this market","type":"boolean"},"t":{"description":"Tokens for this market","items":{"$ref":"#/components/schemas/Response68C5148660B1_ClobToken"},"type":"array"},"tbf":{"description":"Taker base fee in basis points","example":0,"format":"int64","type":"integer"}},"type":"object"},"Response68C5148660B1_ClobRewards":{"additionalProperties":true,"description":"Rewards configuration for a market.","type":"object"},"Response68C5148660B1_ClobToken":{"description":"A token in a CLOB market with its ID and outcome label.","properties":{"o":{"description":"Outcome label for the token (e.g. \"Yes\", \"No\")","example":"Yes","type":"string"},"t":{"description":"The token ID","example":"71321045679252212594626385532706912750332728571942532289631379312455583992563","type":"string"}},"type":"object"},"Response68C5148660B1_CurrentReward":{"description":"Current active reward configuration for a market","properties":{"condition_id":{"description":"Condition ID of the market","type":"string"},"native_daily_rate":{"description":"Computed native daily rate excluding sponsors (omitted when zero)","format":"double","type":"number"},"rewards_config":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_CurrentRewardConfig"},"type":"array"},"rewards_max_spread":{"description":"Maximum spread for rewards eligibility","type":"number"},"rewards_min_size":{"description":"Minimum order size for rewards eligibility","type":"number"},"sponsored_daily_rate":{"description":"Sponsored daily rate (omitted when zero)","format":"double","type":"number"},"sponsors_count":{"description":"Number of sponsors (omitted when zero)","type":"integer"},"total_daily_rate":{"description":"Computed total daily rate including sponsors (omitted when zero)","format":"double","type":"number"}},"required":["condition_id"],"type":"object"},"Response68C5148660B1_CurrentRewardConfig":{"description":"Reward configuration entry for a current rewards market","properties":{"asset_address":{"description":"Address of the reward asset","type":"string"},"end_date":{"description":"End date of the rewards period","format":"date","type":"string"},"id":{"description":"Rewards config ID (always 0 on /rewards/markets/current)","type":"integer"},"rate_per_day":{"description":"Daily reward rate","format":"double","type":"number"},"start_date":{"description":"Start date of the rewards period","format":"date","type":"string"},"total_rewards":{"description":"Total rewards amount","format":"double","type":"number"}},"required":["asset_address","start_date","rate_per_day"],"type":"object"},"Response68C5148660B1_FeeDetails":{"description":"Fee curve parameters for a market.","properties":{"e":{"description":"Fee curve exponent","example":2,"format":"float","nullable":true,"type":"number"},"r":{"description":"Fee rate","example":0.02,"format":"float","nullable":true,"type":"number"},"to":{"description":"Whether fees apply to takers only","example":true,"nullable":true,"type":"boolean"}},"type":"object"},"Response68C5148660B1_FeeRate":{"properties":{"base_fee":{"description":"Base fee in basis points","example":30,"format":"int64","type":"integer"}},"required":["base_fee"],"type":"object"},"Response68C5148660B1_HeartbeatResponse":{"description":"Response for heartbeat request","properties":{"status":{"description":"Status of the heartbeat acknowledgment","example":"ok","type":"string"}},"required":["status"],"type":"object"},"Response68C5148660B1_Market":{"properties":{"accepting_order_timestamp":{"format":"date-time","type":"string"},"accepting_orders":{"type":"boolean"},"active":{"type":"boolean"},"archived":{"type":"boolean"},"closed":{"type":"boolean"},"condition_id":{"type":"string"},"description":{"type":"string"},"enable_order_book":{"type":"boolean"},"end_date_iso":{"format":"date-time","type":"string"},"fpmm":{"type":"string"},"game_start_time":{"format":"date-time","type":"string"},"icon":{"type":"string"},"image":{"type":"string"},"is_50_50_outcome":{"type":"boolean"},"maker_base_fee":{"format":"int64","type":"integer"},"market_slug":{"type":"string"},"minimum_order_size":{"format":"double","type":"number"},"minimum_tick_size":{"format":"double","type":"number"},"neg_risk":{"type":"boolean"},"neg_risk_market_id":{"type":"string"},"neg_risk_request_id":{"type":"string"},"notifications_enabled":{"type":"boolean"},"question":{"type":"string"},"question_id":{"type":"string"},"rewards":{"$ref":"#/components/schemas/Response68C5148660B1_Rewards"},"seconds_delay":{"type":"integer"},"tags":{"items":{"type":"string"},"type":"array"},"taker_base_fee":{"format":"int64","type":"integer"},"tokens":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_Token"},"type":"array"}},"type":"object"},"Response68C5148660B1_MarketByTokenResponse":{"description":"Response for GET /markets-by-token/{token_id} — condition ID and both token IDs in the market.","properties":{"condition_id":{"description":"The condition ID of the market containing the given token","example":"0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af","type":"string"},"primary_token_id":{"description":"The primary (Yes) token ID","example":"71321045679252212594626385532706912750332728571942532289631379312455583992563","type":"string"},"secondary_token_id":{"description":"The secondary (No) token ID","example":"52114319501245915516055106046884209969926127482827954674443846427813813222426","type":"string"}},"required":["condition_id","primary_token_id","secondary_token_id"],"type":"object"},"Response68C5148660B1_MarketPrice":{"properties":{"p":{"format":"float","type":"number"},"t":{"format":"uint32","type":"integer"}},"type":"object"},"Response68C5148660B1_MarketReward":{"description":"Market with raw reward configurations","properties":{"condition_id":{"description":"Condition ID of the market","type":"string"},"event_slug":{"description":"URL slug for the event","type":"string"},"image":{"description":"URL to market image","type":"string"},"market_competitiveness":{"description":"Competitiveness score of the market","format":"double","type":"number"},"market_slug":{"description":"URL slug for the market","type":"string"},"question":{"description":"Market question","type":"string"},"rewards_config":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_RewardsConfig"},"type":"array"},"rewards_max_spread":{"description":"Maximum spread for rewards eligibility","type":"number"},"rewards_min_size":{"description":"Minimum order size for rewards eligibility","type":"number"},"tokens":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_RewardsToken"},"type":"array"}},"required":["condition_id","question","tokens"],"type":"object"},"Response68C5148660B1_MultiMarketInfo":{"description":"Market with rewards configuration and trading metrics","properties":{"condition_id":{"description":"Condition ID of the market","type":"string"},"created_at":{"description":"Market creation timestamp","format":"date-time","type":"string"},"end_date":{"description":"Market end date","type":"string"},"event_id":{"description":"Event ID","type":"string"},"event_slug":{"description":"URL slug for the event","type":"string"},"group_item_title":{"description":"Title within an event group","type":"string"},"image":{"description":"URL to market image","type":"string"},"market_competitiveness":{"description":"Competitiveness score of the market","format":"double","type":"number"},"market_id":{"description":"Market ID","type":"string"},"market_slug":{"description":"URL slug for the market","type":"string"},"one_day_price_change":{"description":"Price change over the last 24 hours","format":"double","type":"number"},"question":{"description":"Market question","type":"string"},"rewards_config":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_RewardsConfig"},"type":"array"},"rewards_max_spread":{"description":"Maximum spread for rewards eligibility","type":"number"},"rewards_min_size":{"description":"Minimum order size for rewards eligibility","type":"number"},"spread":{"description":"Current spread","format":"double","type":"number"},"tokens":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_RewardsToken"},"type":"array"},"volume_24hr":{"description":"24-hour trading volume","format":"double","type":"number"}},"required":["condition_id","market_id","question","tokens"],"type":"object"},"Response68C5148660B1_OpenOrder":{"properties":{"asset_id":{"description":"Asset ID (token ID)","example":"0xabc123def456...","type":"string"},"associate_trades":{"description":"Array of associated trade IDs","example":["trade-123"],"items":{"type":"string"},"type":"array"},"created_at":{"description":"Unix timestamp when the order was created","example":1700000000,"type":"integer"},"expiration":{"description":"Unix timestamp when the order expires","example":"1735689600","type":"string"},"id":{"description":"Order ID (order hash)","example":"0xabcdef1234567890abcdef1234567890abcdef12","type":"string"},"maker_address":{"description":"Ethereum address of the maker","example":"0x1234567890123456789012345678901234567890","type":"string"},"market":{"description":"Market (condition ID)","example":"0x0000000000000000000000000000000000000000000000000000000000000001","type":"string"},"order_type":{"description":"Order type","enum":["GTC","FOK","GTD","FAK"],"example":"GTC","type":"string"},"original_size":{"description":"Original order size in shares, as a decimal string. Already normalized; do not divide by 1e6.","example":"100","type":"string"},"outcome":{"description":"Market outcome (YES/NO)","example":"YES","type":"string"},"owner":{"description":"UUID of the order owner","example":"f4f247b7-4ac7-ff29-a152-04fda0a8755a","type":"string"},"price":{"description":"Order price","example":"0.5","type":"string"},"side":{"description":"Order side","enum":["BUY","SELL"],"example":"BUY","type":"string"},"size_matched":{"description":"Matched size in shares, as a decimal string. Retained after cancellation; this is not the current position balance.","example":"0","type":"string"},"status":{"description":"Order status. CANCELED_MARKET_RESOLVED cancels the unfilled remainder when the market resolves; it does not undo settled fills.","enum":["LIVE","INVALID","CANCELED_MARKET_RESOLVED","CANCELED","MATCHED"],"type":"string"}},"required":["id","status","owner","maker_address","market","asset_id","side","original_size","size_matched","price","expiration","order_type","created_at","outcome"],"type":"object"},"Response68C5148660B1_OrderBookSummary":{"properties":{"asks":{"description":"List of ask orders (sorted by price ascending)","items":{"$ref":"#/components/schemas/Response68C5148660B1_OrderSummary"},"type":"array"},"asset_id":{"description":"Token ID (asset ID)","example":"0xabc123def456...","type":"string"},"bids":{"description":"List of bid orders (sorted by price descending)","items":{"$ref":"#/components/schemas/Response68C5148660B1_OrderSummary"},"type":"array"},"hash":{"description":"Hash of the order book summary","example":"a1b2c3d4e5f6...","type":"string"},"last_trade_price":{"description":"Last trade price","example":"0.45","type":"string"},"market":{"description":"Market condition ID","example":"0x1234567890123456789012345678901234567890","type":"string"},"min_order_size":{"description":"Minimum order size","example":"1","type":"string"},"neg_risk":{"description":"Whether negative risk is enabled for this market","example":false,"type":"boolean"},"tick_size":{"description":"Minimum price increment (tick size)","example":"0.01","type":"string"},"timestamp":{"description":"Timestamp of the order book snapshot","example":"1234567890","type":"string"}},"required":["market","asset_id","timestamp","hash","bids","asks","min_order_size","tick_size","neg_risk","last_trade_price"],"type":"object"},"Response68C5148660B1_OrderScoringResponse":{"description":"Response indicating whether an order is currently scoring for rewards","properties":{"scoring":{"description":"Whether the order is currently scoring for maker rewards","example":true,"type":"boolean"}},"required":["scoring"],"type":"object"},"Response68C5148660B1_OrderSummary":{"properties":{"price":{"description":"Order price","example":"0.45","type":"string"},"size":{"description":"Order size","example":"100","type":"string"}},"required":["price","size"],"type":"object"},"Response68C5148660B1_OrdersResponse":{"properties":{"count":{"description":"Number of orders in this response","example":2,"type":"integer"},"data":{"description":"Array of open orders","items":{"$ref":"#/components/schemas/Response68C5148660B1_OpenOrder"},"type":"array"},"limit":{"description":"Maximum number of results per page","example":100,"type":"integer"},"next_cursor":{"description":"Cursor for pagination (base64 encoded offset). Empty if no more results.","example":"MTAw","type":"string"}},"required":["limit","next_cursor","count","data"],"type":"object"},"Response68C5148660B1_PaginatedCurrentReward":{"description":"Paginated list of current reward configurations","properties":{"count":{"description":"Number of items in the current response","type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_CurrentReward"},"type":"array"},"limit":{"description":"Maximum number of items per page","type":"integer"},"next_cursor":{"description":"Cursor for the next page. \"LTE=\" indicates the last page.","type":"string"}},"required":["limit","count","next_cursor","data"],"type":"object"},"Response68C5148660B1_PaginatedMarketReward":{"description":"Paginated list of market reward configurations","properties":{"count":{"description":"Number of items in the current response","type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_MarketReward"},"type":"array"},"limit":{"description":"Maximum number of items per page","type":"integer"},"next_cursor":{"description":"Cursor for the next page. \"LTE=\" indicates the last page.","type":"string"}},"required":["limit","count","next_cursor","data"],"type":"object"},"Response68C5148660B1_PaginatedMarkets":{"properties":{"count":{"type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_Market"},"type":"array"},"limit":{"type":"integer"},"next_cursor":{"type":"string"}},"type":"object"},"Response68C5148660B1_PaginatedMultiMarketInfo":{"description":"Paginated list of markets with rewards and trading metrics","properties":{"count":{"description":"Number of items in the current response","type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_MultiMarketInfo"},"type":"array"},"limit":{"description":"Maximum number of items per page","type":"integer"},"next_cursor":{"description":"Cursor for the next page. \"LTE=\" indicates the last page.","type":"string"}},"required":["limit","count","next_cursor","data"],"type":"object"},"Response68C5148660B1_PaginatedSimplifiedMarkets":{"properties":{"count":{"type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_SimplifiedMarket"},"type":"array"},"limit":{"type":"integer"},"next_cursor":{"type":"string"}},"type":"object"},"Response68C5148660B1_PaginatedUserEarnings":{"description":"Paginated list of user earnings","properties":{"count":{"description":"Number of items in the current response","type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_UserEarning"},"type":"array"},"limit":{"description":"Maximum number of items per page","type":"integer"},"next_cursor":{"description":"Cursor for the next page. \"LTE=\" indicates the last page.","type":"string"}},"required":["limit","count","next_cursor","data"],"type":"object"},"Response68C5148660B1_PaginatedUserRewardsMarkets":{"description":"Paginated list of user rewards markets","properties":{"count":{"description":"Number of items in the current response","type":"integer"},"data":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_UserRewardsMarket"},"type":"array"},"limit":{"description":"Maximum number of items per page","type":"integer"},"next_cursor":{"description":"Cursor for the next page. \"LTE=\" indicates the last page.","type":"string"},"total_count":{"description":"Total number of items across all pages","type":"integer"}},"required":["limit","count","next_cursor","data"],"type":"object"},"Response68C5148660B1_PricesHistoryResponse":{"properties":{"history":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_MarketPrice"},"type":"array"}},"type":"object"},"Response68C5148660B1_RebatedFees":{"description":"Rebated fees for a maker on a specific market and date","properties":{"asset_address":{"description":"Asset address (e.g. USDC contract)","example":"0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB","type":"string"},"condition_id":{"description":"Condition ID of the market","example":"0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af","type":"string"},"date":{"description":"Date of the rebate (YYYY-MM-DD)","example":"2026-02-27","type":"string"},"maker_address":{"description":"Maker's Ethereum address","example":"0xFeA4cB3dD4ca7CefD3368653B7D6FF9BcDFca604","type":"string"},"rebated_fees_usdc":{"description":"Rebated fee amount in USDC","example":"0.237519","type":"string"}},"required":["date","condition_id","asset_address","maker_address","rebated_fees_usdc"],"type":"object"},"Response68C5148660B1_Rewards":{"properties":{"max_spread":{"format":"double","type":"number"},"min_size":{"format":"double","type":"number"},"rates":{"items":{"properties":{"asset_address":{"type":"string"},"rewards_daily_rate":{"format":"double","type":"number"}},"type":"object"},"type":"array"}},"type":"object"},"Response68C5148660B1_RewardsConfig":{"description":"Rewards configuration for a market","properties":{"asset_address":{"description":"Address of the reward asset","type":"string"},"end_date":{"description":"End date of the rewards period","format":"date","type":"string"},"id":{"description":"Rewards config ID","type":"integer"},"rate_per_day":{"description":"Daily reward rate","format":"double","type":"number"},"remaining_reward_amount":{"description":"Remaining reward amount","format":"double","type":"number"},"start_date":{"description":"Start date of the rewards period","format":"date","type":"string"},"total_days":{"description":"Total number of days in the rewards period","type":"integer"},"total_rewards":{"description":"Total rewards amount","format":"double","type":"number"}},"required":["asset_address","start_date","rate_per_day"],"type":"object"},"Response68C5148660B1_RewardsToken":{"description":"Token information for rewards markets","properties":{"outcome":{"description":"Outcome name (e.g., \"YES\", \"NO\")","type":"string"},"price":{"description":"Current price of the token","format":"double","type":"number"},"token_id":{"description":"Token ID","type":"string"}},"required":["token_id","outcome"],"type":"object"},"Response68C5148660B1_SendOrderResponse":{"properties":{"errorMsg":{"description":"Error message (empty on success)","example":"","type":"string"},"makingAmount":{"description":"Amount the maker is providing in fixed-math with 6 decimals","example":"100000000","type":"string"},"orderID":{"description":"Unique identifier for the order (order hash)","example":"0xabcdef1234567890abcdef1234567890abcdef12","type":"string"},"status":{"description":"Status of the order after processing","enum":["live","matched","delayed"],"type":"string"},"success":{"description":"Whether the order was successfully processed","example":true,"type":"boolean"},"takingAmount":{"description":"Amount the taker is providing in fixed-math with 6 decimals","example":"200000000","type":"string"},"tradeIDs":{"description":"Array of trade IDs (present when status is 'matched')","items":{"type":"string"},"type":"array"},"transactionsHashes":{"description":"Array of transaction hashes (present when status is 'matched')","example":["0x1234567890abcdef1234567890abcdef12345678"],"items":{"type":"string"},"type":"array"}},"required":["success","orderID","status"],"type":"object"},"Response68C5148660B1_SimplifiedMarket":{"properties":{"accepting_orders":{"type":"boolean"},"active":{"type":"boolean"},"archived":{"type":"boolean"},"closed":{"type":"boolean"},"condition_id":{"type":"string"},"rewards":{"$ref":"#/components/schemas/Response68C5148660B1_Rewards"},"tokens":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_Token"},"type":"array"}},"type":"object"},"Response68C5148660B1_TickSize":{"properties":{"minimum_tick_size":{"description":"Minimum tick size (price increment)","example":0.01,"format":"double","type":"number"}},"required":["minimum_tick_size"],"type":"object"},"Response68C5148660B1_Token":{"properties":{"outcome":{"type":"string"},"price":{"format":"double","type":"number"},"token_id":{"type":"string"},"winner":{"type":"boolean"}},"type":"object"},"Response68C5148660B1_TotalUserEarning":{"description":"Total user earnings for a given day grouped by asset","properties":{"asset_address":{"description":"Address of the reward asset","type":"string"},"asset_rate":{"description":"Exchange rate of the asset","format":"double","type":"number"},"date":{"description":"Date of the earnings","format":"date-time","type":"string"},"earnings":{"description":"Total amount of earnings in the asset","format":"double","type":"number"},"maker_address":{"description":"Address of the maker","type":"string"}},"required":["date","asset_address","maker_address","earnings","asset_rate"],"type":"object"},"Response68C5148660B1_UserEarning":{"description":"User earnings for a specific market on a given day","properties":{"asset_address":{"description":"Address of the reward asset","type":"string"},"asset_rate":{"description":"Exchange rate of the asset","format":"double","type":"number"},"condition_id":{"description":"Condition ID of the market","type":"string"},"date":{"description":"Date of the earnings","format":"date-time","type":"string"},"earnings":{"description":"Amount of earnings in the asset","format":"double","type":"number"},"maker_address":{"description":"Address of the maker","type":"string"}},"required":["date","condition_id","asset_address","maker_address","earnings"],"type":"object"},"Response68C5148660B1_UserRewardsMarket":{"description":"Market with user rewards earnings and configuration","properties":{"condition_id":{"description":"Condition ID of the market","type":"string"},"earning_percentage":{"description":"Percentage of total rewards the user is earning","format":"double","type":"number"},"earnings":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_AssetEarning"},"type":"array"},"event_id":{"description":"Event ID","type":"string"},"event_slug":{"description":"URL slug for the event","type":"string"},"image":{"description":"URL to market image","type":"string"},"maker_address":{"description":"Maker address","type":"string"},"market_competitiveness":{"description":"Competitiveness score of the market","format":"double","type":"number"},"market_id":{"description":"Market ID","type":"string"},"market_slug":{"description":"URL slug for the market","type":"string"},"question":{"description":"Market question","type":"string"},"rewards_config":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_CurrentRewardConfig"},"type":"array"},"rewards_max_spread":{"description":"Maximum spread for rewards eligibility","type":"number"},"rewards_min_size":{"description":"Minimum order size for rewards eligibility","type":"number"},"spread":{"description":"Current spread","format":"double","type":"number"},"tokens":{"items":{"$ref":"#/components/schemas/Response68C5148660B1_RewardsToken"},"type":"array"},"volume_24hr":{"description":"24-hour trading volume","format":"double","type":"number"}},"required":["condition_id","market_id","question","tokens"],"type":"object"},"Response73D081Cabc11_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response73D692Ab31Ca_ListGenerationResponse":{"properties":{"count":{"description":"Number of companies returned.","type":"integer"},"credits_consumed":{"description":"Credits consumed. Returns 0 when no enrichment sections requested.","format":"float","type":"number"},"data":{"items":{"description":"Company object with identity fields (uuid, name, website) plus any requested enrichment sections.","type":"object"},"type":"array"},"total_count":{"description":"Total matching companies. Capped at 500.","type":"integer"}},"type":"object"},"Response73D692Ab31Ca_TranslateQueryResponse":{"properties":{"credits_consumed":{"format":"float","type":"number"},"data":{"properties":{"filters":{"description":"Structured filters object equivalent to the input query, using dotted-path filter keys.","type":"object"}},"type":"object"}},"type":"object"},"Response758Fcfa4290B_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response762Cca4421D2_Action":{"description":"A model representing an action to be taken.","properties":{"type":{"description":"The type representing the action.","title":"Type","type":"string"},"url":{"description":"A URL representing the action to be taken.","title":"Url","type":"string"}},"required":["type","url"],"title":"Action","type":"object"},"Response762Cca4421D2_AddressResult":{"description":"A result representing a street address or a street.","properties":{"coordinates":{"description":"A pair of coordinates (lat, long) for the address.","maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"title":"Coordinates","type":"array"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"Distance from the user’s geolocation, if available."},"name":{"description":"The name of the address.","title":"Name","type":"string"},"pois":{"default":[],"description":"POIs located at this address.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},"title":"Pois","type":"array"},"pois_nearby":{"default":[],"description":"POIs located nearby this address.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},"title":"Pois Nearby","type":"array"},"postal_address":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_PostalAddress"},{"type":"null"}],"description":"Structured postal address."},"type":{"default":"address","description":"Result type identifier. address when the result refers to an explicit street + number, street when it refers to the street itself.","enum":["address","street"],"title":"Type","type":"string"},"zoom_level":{"default":15,"description":"Suggested zoom level on the map.","title":"Zoom Level","type":"integer"}},"required":["name","coordinates"],"title":"AddressResult","type":"object"},"Response762Cca4421D2_Answer":{"description":"A response representing an answer to a question on a forum.","properties":{"author":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the author of the answer.","title":"Author"},"downvoteCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of downvotes on the answer.","title":"Downvotecount"},"text":{"description":"The main content of the answer.","title":"Text","type":"string"},"upvoteCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of upvotes on the answer.","title":"Upvotecount"}},"required":["text"],"title":"Answer","type":"object"},"Response762Cca4421D2_Article":{"description":"A model representing an article.","properties":{"author":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Person"},"type":"array"},{"type":"null"}],"description":"The author of the article.","title":"Author"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The date when the article was published.","title":"Date"},"isAccessibleForFree":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the article is free to read or is behind a paywall.","title":"Isaccessibleforfree"},"publisher":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Organization"},{"type":"null"}],"description":"The name of the publisher for the article."},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"A thumbnail associated with the article."}},"title":"Article","type":"object"},"Response762Cca4421D2_AssetInfo":{"properties":{"category":{"$ref":"#/components/schemas/Response762Cca4421D2_FinancialInstrumentCategory"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"currency":{"title":"Currency","type":"string"},"exchange":{"title":"Exchange","type":"string"},"mic_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mic Code"},"name":{"title":"Name","type":"string"},"score":{"default":-1,"title":"Score","type":"number"},"symbol":{"title":"Symbol","type":"string"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"required":["symbol","name","category","currency","exchange"],"title":"AssetInfo","type":"object"},"Response762Cca4421D2_Book":{"description":"A model representing a book result.","properties":{"author":{"description":"The author of the book.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_Person"},"title":"Author","type":"array"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The publishing date of the book.","title":"Date"},"pages":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of pages in the book.","title":"Pages"},"price":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Price"},{"type":"null"}],"description":"The price of the book."},"publisher":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Person"},{"type":"null"}],"description":"The publisher of the book."},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"A gathered rating from different sources associated with the book."},"title":{"description":"The title of the book.","title":"Title","type":"string"}},"required":["title","author"],"title":"Book","type":"object"},"Response762Cca4421D2_ButtonResult":{"description":"A result which can be used as a button.","properties":{"title":{"description":"The title of the result.","title":"Title","type":"string"},"type":{"const":"button_result","default":"button_result","description":"A type identifying button result. The value is always button_result.","enum":["button_result"],"title":"Type","type":"string"},"url":{"description":"The URL for the button result.","title":"Url","type":"string"}},"required":["title","url"],"title":"ButtonResult","type":"object"},"Response762Cca4421D2_CalculatorResult":{"properties":{"answer":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Answer"},"expression":{"title":"Expression","type":"string"}},"required":["expression"],"title":"CalculatorResult","type":"object"},"Response762Cca4421D2_ChoiceChunk":{"properties":{"delta":{"$ref":"#/components/schemas/Response762Cca4421D2_Delta"},"finish_reason":{"anyOf":[{"enum":["stop","length"],"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"required":["delta"],"title":"ChoiceChunk","type":"object"},"Response762Cca4421D2_CityResult":{"description":"A result representing a city.","properties":{"coordinates":{"description":"A pair of coordinates (lat, long) for the city.","maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"title":"Coordinates","type":"array"},"country":{"description":"The country of the city.","title":"Country","type":"string"},"name":{"description":"The name of the city.","title":"Name","type":"string"},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"Primary image for the city."},"type":{"const":"city","default":"city","description":"City result type identifier. The value is always city.","enum":["city"],"title":"Type","type":"string"}},"required":["name","country","coordinates","thumbnail"],"title":"CityResult","type":"object"},"Response762Cca4421D2_Contact":{"description":"A model representing contact information for an entity.","properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The email address.","title":"Email"},"telephone":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The telephone number.","title":"Telephone"}},"title":"Contact","type":"object"},"Response762Cca4421D2_ContactPoint":{"description":"A way to contact an entity.","properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The email address of the entity.","title":"Email"},"name":{"description":"The name of the thing.","title":"Name","type":"string"},"telephone":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The telephone number of the entity.","title":"Telephone"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"Thumbnail associated with the thing."},"type":{"default":"contact_point","description":"A type string identifying a contact point. The value is always contact_point.","title":"Type","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A URL for the thing.","title":"Url"}},"required":["name"],"title":"ContactPoint","type":"object"},"Response762Cca4421D2_Conversion":{"properties":{"amount":{"title":"Amount","type":"number"},"date":{"title":"Date","type":"string"},"info":{"$ref":"#/components/schemas/Response762Cca4421D2_Info"},"query":{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__rich_header__results__currencies__v1__Query"},"result":{"title":"Result","type":"number"}},"required":["query","info","date","result","amount"],"title":"Conversion","type":"object"},"Response762Cca4421D2_Coordinates":{"properties":{"lat":{"title":"Lat","type":"number"},"lon":{"title":"Lon","type":"number"}},"required":["lat","lon"],"title":"Coordinates","type":"object"},"Response762Cca4421D2_CountryResult":{"description":"A result representing a country.","properties":{"coordinates":{"description":"A pair of coordinates (lat, long) for the country.","maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"title":"Coordinates","type":"array"},"country":{"description":"The country of the result.","title":"Country","type":"string"},"name":{"description":"The name of the country.","title":"Name","type":"string"},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"Primary image for the country."},"type":{"const":"country","default":"country","description":"Country result type identifier. The value is always country.","enum":["country"],"title":"Type","type":"string"}},"required":["name","country","coordinates","thumbnail"],"title":"CountryResult","type":"object"},"Response762Cca4421D2_Courier":{"properties":{"code":{"title":"Code","type":"string"},"domain":{"title":"Domain","type":"string"},"name":{"title":"Name","type":"string"},"service":{"title":"Service","type":"string"}},"required":["name","service","code","domain"],"title":"Courier","type":"object"},"Response762Cca4421D2_CreativeWork":{"description":"A creative work relevant to the query. An example can be enriched metadata for an app.","properties":{"name":{"description":"The name of the creative work.","minLength":1,"title":"Name","type":"string"},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"A rating that is given to the creative work."},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"A thumbnail associated with the creative work."}},"required":["name","thumbnail"],"title":"CreativeWork","type":"object"},"Response762Cca4421D2_CryptocurrencyItem":{"properties":{"label":{"title":"Label","type":"string"},"symbol":{"title":"Symbol","type":"string"},"value":{"title":"Value","type":"string"}},"required":["label","value","symbol"],"title":"CryptocurrencyItem","type":"object"},"Response762Cca4421D2_CryptocurrencyResult":{"properties":{"amount":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Amount"},"currency":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_CurrencyForex"},{"type":"null"}]},"intent_type":{"enum":["lookup","conversion"],"title":"Intent Type","type":"string"},"quote":{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__rich_header__results__cryptocurrencies__v1__Quote"},"timeseries":{"$ref":"#/components/schemas/Response762Cca4421D2_CryptocurrencyResultTimeseries"},"top100_crypto":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_CryptocurrencyItem"},"title":"Top100 Crypto","type":"array"},"vs_currencies":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_VsCurrency"},"title":"Vs Currencies","type":"array"},"vs_currency":{"title":"Vs Currency","type":"string"}},"required":["intent_type","quote","timeseries","vs_currency"],"title":"CryptocurrencyResult","type":"object"},"Response762Cca4421D2_CryptocurrencyResultTimeseries":{"properties":{"time_range":{"$ref":"#/components/schemas/Response762Cca4421D2_TickerPlotTimeRange"},"ts_market_cap":{"items":{"maxItems":2,"minItems":2,"prefixItems":[{"type":"integer"},{"type":"number"}],"type":"array"},"title":"Ts Market Cap","type":"array"},"ts_price":{"items":{"maxItems":2,"minItems":2,"prefixItems":[{"type":"integer"},{"type":"number"}],"type":"array"},"title":"Ts Price","type":"array"},"ts_volume":{"items":{"maxItems":2,"minItems":2,"prefixItems":[{"type":"integer"},{"type":"number"}],"type":"array"},"title":"Ts Volume","type":"array"}},"required":["time_range","ts_price","ts_market_cap","ts_volume"],"title":"CryptocurrencyResultTimeseries","type":"object"},"Response762Cca4421D2_Currency":{"properties":{"code":{"title":"Code","type":"string"},"decimals":{"title":"Decimals","type":"integer"},"full_name":{"title":"Full Name","type":"string"}},"required":["full_name","code","decimals"],"title":"Currency","type":"object"},"Response762Cca4421D2_CurrencyForex":{"properties":{"code":{"title":"Code","type":"string"},"decimals":{"title":"Decimals","type":"integer"},"full_name":{"title":"Full Name","type":"string"}},"required":["full_name","code","decimals"],"title":"CurrencyForex","type":"object"},"Response762Cca4421D2_CurrencyResult":{"properties":{"conversion":{"$ref":"#/components/schemas/Response762Cca4421D2_Conversion"},"supported_currencies":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Currency"},"title":"Supported Currencies","type":"array"},"timeseries":{"$ref":"#/components/schemas/Response762Cca4421D2_Timeseries"}},"required":["conversion","timeseries"],"title":"CurrencyResult","type":"object"},"Response762Cca4421D2_CurrentWeather":{"properties":{"clouds":{"title":"Clouds","type":"integer"},"dew_point":{"title":"Dew Point","type":"number"},"feels_like":{"title":"Feels Like","type":"number"},"humidity":{"title":"Humidity","type":"integer"},"pressure":{"title":"Pressure","type":"integer"},"rain":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rain"},"snow":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snow"},"sunrise":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sunrise"},"sunset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sunset"},"temp":{"title":"Temp","type":"number"},"ts":{"title":"Ts","type":"integer"},"uvi":{"title":"Uvi","type":"number"},"visibility":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Visibility"},"weather":{"$ref":"#/components/schemas/Response762Cca4421D2_WeatherSnapshot"},"wind":{"$ref":"#/components/schemas/Response762Cca4421D2_WindSnapshot"}},"required":["ts","temp","feels_like","pressure","humidity","dew_point","uvi","clouds","visibility","wind","weather"],"title":"CurrentWeather","type":"object"},"Response762Cca4421D2_DateToTs":{"properties":{"input_date":{"title":"Input Date","type":"string"},"intent_type":{"const":"date_to_ts","default":"date_to_ts","enum":["date_to_ts"],"title":"Intent Type","type":"string"}},"required":["input_date"],"title":"DateToTs","type":"object"},"Response762Cca4421D2_DayOpeningHours":{"description":"A model representing the opening hours for a particular day for a business at a particular location.","properties":{"abbr_name":{"description":"A short string representing the day of the week.","title":"Abbr Name","type":"string"},"closes":{"description":"A 24 hr clock time string for the closing time of the business on a particular day.","title":"Closes","type":"string"},"full_name":{"description":"A full string representing the day of the week.","title":"Full Name","type":"string"},"opens":{"description":"A 24 hr clock time string for the opening time of the business on a particular day.","title":"Opens","type":"string"}},"required":["abbr_name","full_name","opens","closes"],"title":"DayOpeningHours","type":"object"},"Response762Cca4421D2_DeepResult":{"description":"Aggregated deep results from news, social, videos and images.","properties":{"buttons":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_ButtonResult"},"type":"array"},{"type":"null"}],"description":"A list of buttoned results associated with the result.","title":"Buttons"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Image"},"type":"array"},{"type":"null"}],"description":"Images associated with the result.","title":"Images"},"news":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__NewsResult"},"type":"array"},{"type":"null"}],"description":"A list of news results associated with the result.","title":"News"},"videos":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__VideoResult"},"type":"array"},{"type":"null"}],"description":"Videos associated with the result.","title":"Videos"}},"title":"DeepResult","type":"object"},"Response762Cca4421D2_Definition":{"properties":{"definitions":{"items":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_DefinitionText"},{"type":"string"}]},"title":"Definitions","type":"array"},"part_of_speech":{"title":"Part Of Speech","type":"string"}},"required":["part_of_speech","definitions"],"title":"Definition","type":"object"},"Response762Cca4421D2_DefinitionLabel":{"properties":{"text":{"title":"Text","type":"string"},"type":{"title":"Type","type":"string"}},"required":["text","type"],"title":"DefinitionLabel","type":"object"},"Response762Cca4421D2_DefinitionText":{"properties":{"example_uses":{"items":{"type":"string"},"title":"Example Uses","type":"array"},"labels":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_DefinitionLabel"},"title":"Labels","type":"array"},"related_words":{"items":{"type":"string"},"title":"Related Words","type":"array"},"text":{"title":"Text","type":"string"}},"required":["text","example_uses","related_words","labels"],"title":"DefinitionText","type":"object"},"Response762Cca4421D2_DefinitionsResult":{"properties":{"attribution_text":{"title":"Attribution Text","type":"string"},"attribution_url":{"title":"Attribution Url","type":"string"},"audio_available":{"default":false,"title":"Audio Available","type":"boolean"},"definitions":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Definition"},"title":"Definitions","type":"array"},"language":{"title":"Language","type":"string"},"pronounciation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pronounciation"},"source_dict":{"title":"Source Dict","type":"string"},"word":{"title":"Word","type":"string"}},"required":["word","language","definitions","source_dict","attribution_text","attribution_url"],"title":"DefinitionsResult","type":"object"},"Response762Cca4421D2_Delta":{"properties":{"content":{"title":"Content","type":"string"},"role":{"const":"assistant","default":"assistant","enum":["assistant"],"title":"Role","type":"string"}},"required":["content"],"title":"Delta","type":"object"},"Response762Cca4421D2_DiscussionResult":{"description":"A discussion result. These are forum posts and discussions that are relevant to the search query.","properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A human-readable representation of the web search result’s age. For example, 2 days ago.","title":"Age"},"article":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Article"},{"type":"null"}],"description":"An article found for the web search result page."},"book":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Book"},{"type":"null"}],"description":"Any book information associated with the web search result page."},"cluster":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Result"},"type":"array"},{"type":"null"}],"description":"A list of web search results.","title":"Cluster"},"cluster_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A type representing a cluster. The value can be product_cluster.","title":"Cluster Type"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The content type associated with the search result page.","title":"Content Type"},"creative_work":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_CreativeWork"},{"type":"null"}],"description":"Aggregated information on the creative work found on the web search result."},"data":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_ForumData"},{"type":"null"}],"description":"The enriched aggregated data for the relevant forum post."},"deep_results":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_DeepResult"},{"type":"null"}],"description":"Gathered information on a web search result."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"extra_snippets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of extra alternate snippets for the web search result.","title":"Extra Snippets"},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"faq":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__FAQ"},{"type":"null"}],"description":"Any frequently asked questions associated with the web search result."},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"icons":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_PostprocessedIcon"},"type":"array"},{"type":"null"}],"description":"Icons associated with the search result.","title":"Icons"},"is_live":{"default":false,"description":"Whether the web search result is currently live. Default value is false.","title":"Is Live","type":"boolean"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"default":"en","description":"The main language on the web search result.","title":"Language","type":"string"},"location":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},{"type":"null"}],"description":"The location details if the query relates to a restaurant."},"meta_url":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Aggregated information on the URL associated with the web search result.","title":"Meta Url"},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"The movie associated with the web search result."},"music_recording":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MusicRecording"},{"type":"null"}],"description":"Aggregated information on music recording found on the web search result."},"organization":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Organization"},{"type":"null"}],"description":"Aggregated information on a organization found on the web search result page."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"product":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Product"},{"$ref":"#/components/schemas/Response762Cca4421D2_Review"},{"type":"null"}],"description":"The main product and a review that is found on the web search result page.","title":"Product"},"product_cluster":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Product"},{"$ref":"#/components/schemas/Response762Cca4421D2_Review"}]},"type":"array"},{"type":"null"}],"description":"A list of products and reviews that are found on the web search result page.","title":"Product Cluster"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"qa":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_QAPage"},{"type":"null"}],"description":"Any question answer information associated with the web search result page."},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"Rating found for the web search result page."},"recipe":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Recipe"},{"type":"null"}],"description":"Aggregated information on a recipe found on the web search result page."},"restaurant":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},{"type":"null"}],"deprecated":true,"description":"Deprecated. Use location instead."},"review":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Review"},{"type":"null"}],"description":"Aggregated information on the review found on the web search result."},"schemas":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"description":"A list of schemas (structured data) extracted from the page. The schemas try to follow schema.org and will return anything we can extract from the HTML that can fit into these models.","title":"Schemas"},"software":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Software"},{"type":"null"}],"description":"Aggregated information on a software product found on the web search result page."},"subtype":{"default":"generic","description":"A sub type identifying the web search result type.","title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail of the web search result."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"discussion","default":"discussion","description":"The discussion result type identifier. The value is always discussion.","enum":["discussion"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__VideoData"},{"type":"null"}],"description":"The video associated with the web search result."}},"required":["title","url"],"title":"DiscussionResult","type":"object"},"Response762Cca4421D2_Discussions":{"description":"A model representing a discussion cluster relevant to the query.","properties":{"mutated_by_goggles":{"default":false,"description":"Whether the discussion results are changed by Goggles. The value is false by default.","title":"Mutated By Goggles","type":"boolean"},"results":{"description":"A list of discussion results.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_DiscussionResult"},"title":"Results","type":"array"},"type":{"const":"search","default":"search","description":"The type identifying a discussion cluster. Currently the value is always search.","enum":["search"],"title":"Type","type":"string"}},"required":["results"],"title":"Discussions","type":"object"},"Response762Cca4421D2_EntityInfobox":{"description":"Aggregated information on an entity from a knowledge graph.","properties":{"attributes":{"default":[],"description":"A list of attributes about the entity.","items":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxItems":2,"minItems":2,"type":"array"},"title":"Attributes","type":"array"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Category classification for the entity.","title":"Category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"A unit representing quantity relevant to the entity."},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},"type":"array"},{"type":"null"}],"description":"A list of images relevant to the entity.","title":"Images"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Any label associated with the entity.","title":"Label"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"long_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A longer description for the entity.","title":"Long Desc"},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"Any movie data relevant to the entity. Appears only when the result is a movie."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"position":{"description":"The position on a search result page.","title":"Position","type":"integer"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"profiles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},"type":"array"},{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"The profiles associated with the entity.","title":"Profiles"},"providers":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"A list of data sources for the entity.","title":"Providers"},"ratings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},"type":"array"},{"type":"null"}],"description":"Any ratings given to the entity.","title":"Ratings"},"subtype":{"const":"entity","default":"entity","description":"The infobox subtype identifier. The value is always entity.","enum":["entity"],"title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the entity."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"infobox","default":"infobox","description":"The infobox result type identifier. The value is always infobox.","enum":["infobox"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The official website pertaining to the entity.","title":"Website Url"}},"required":["title","url","position"],"title":"EntityInfobox","type":"object"},"Response762Cca4421D2_ExchangeInfo":{"properties":{"close_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Close Time"},"open_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Open Time"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},"title":"ExchangeInfo","type":"object"},"Response762Cca4421D2_F1Calendar":{"properties":{"next_race":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Race"},{"type":"null"}]},"previous_race":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Race"},{"type":"null"}]},"races":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1RaceRef"},"title":"Races","type":"array"}},"title":"F1Calendar","type":"object"},"Response762Cca4421D2_F1Circuit":{"properties":{"id":{"title":"Id","type":"integer"},"image":{"title":"Image","type":"string"},"name":{"title":"Name","type":"string"}},"required":["id","name","image"],"title":"F1Circuit","type":"object"},"Response762Cca4421D2_F1Competition":{"properties":{"id":{"title":"Id","type":"integer"},"location":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Location"},"name":{"title":"Name","type":"string"}},"required":["id","name","location"],"title":"F1Competition","type":"object"},"Response762Cca4421D2_F1Driver":{"properties":{"abbr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbr"},"id":{"title":"Id","type":"integer"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"name":{"title":"Name","type":"string"},"number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number"}},"required":["id","name"],"title":"F1Driver","type":"object"},"Response762Cca4421D2_F1FastestLap":{"properties":{"driver":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1FastestLapDriver"},{"type":"null"}]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time"}},"title":"F1FastestLap","type":"object"},"Response762Cca4421D2_F1FastestLapDriver":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"}},"title":"F1FastestLapDriver","type":"object"},"Response762Cca4421D2_F1Laps":{"properties":{"current":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"}},"title":"F1Laps","type":"object"},"Response762Cca4421D2_F1Location":{"properties":{"city":{"title":"City","type":"string"},"country":{"title":"Country","type":"string"}},"required":["country","city"],"title":"F1Location","type":"object"},"Response762Cca4421D2_F1Race":{"properties":{"circuit":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Circuit"},"competition":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Competition"},"date":{"title":"Date","type":"string"},"distance":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Distance"},"fastest_lap":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1FastestLap"},{"type":"null"}]},"id":{"title":"Id","type":"integer"},"laps":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Laps"},{"type":"null"}]},"season":{"title":"Season","type":"integer"},"status":{"title":"Status","type":"string"},"type":{"title":"Type","type":"string"}},"required":["id","competition","circuit","season","type","date","status"],"title":"F1Race","type":"object"},"Response762Cca4421D2_F1RaceDetail":{"properties":{"event":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Race"},"qualifying":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Standing"},"type":"array"},{"type":"null"}],"title":"Qualifying"},"sprint_event":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Race"},{"type":"null"}]},"sprint_shootout":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Standing"},"type":"array"},{"type":"null"}],"title":"Sprint Shootout"},"sprint_standings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Standing"},"type":"array"},{"type":"null"}],"title":"Sprint Standings"},"standings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Standing"},"type":"array"},{"type":"null"}],"title":"Standings"},"weekend_events":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1WeekendEvent"},"type":"array"},{"type":"null"}],"title":"Weekend Events"}},"required":["event"],"title":"F1RaceDetail","type":"object"},"Response762Cca4421D2_F1RaceRef":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"id":{"title":"Id","type":"integer"},"name":{"title":"Name","type":"string"}},"required":["id","name"],"title":"F1RaceRef","type":"object"},"Response762Cca4421D2_F1Standing":{"properties":{"behind":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Behind"},"driver":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Driver"},{"type":"null"}]},"gap":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gap"},"grid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grid"},"laps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Laps"},"points":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Points"},"position":{"title":"Position","type":"integer"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Season"},"team":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Team"},{"type":"null"}]},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time"},"wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wins"}},"required":["position"],"title":"F1Standing","type":"object"},"Response762Cca4421D2_F1Team":{"properties":{"id":{"title":"Id","type":"integer"},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo"},"name":{"title":"Name","type":"string"}},"required":["id","name"],"title":"F1Team","type":"object"},"Response762Cca4421D2_F1WeekendEvent":{"properties":{"date":{"title":"Date","type":"string"},"status":{"title":"Status","type":"string"},"type":{"title":"Type","type":"string"}},"required":["type","date","status"],"title":"F1WeekendEvent","type":"object"},"Response762Cca4421D2_FinancialInstrumentCategory":{"enum":["stock","index","fund","etf","bond","other"],"title":"FinancialInstrumentCategory","type":"string"},"Response762Cca4421D2_Formula1Result":{"properties":{"calendar":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1Calendar"},{"type":"null"}]},"constructors":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Standing"},"type":"array"},{"type":"null"}],"title":"Constructors"},"default_view":{"anyOf":[{"enum":["schedule","drivers","constructors"],"type":"string"},{"type":"null"}],"title":"Default View"},"drivers":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_F1Standing"},"type":"array"},{"type":"null"}],"title":"Drivers"},"live_race":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1RaceDetail"},{"type":"null"}]},"next_race":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1RaceDetail"},{"type":"null"}]},"previous_race":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_F1RaceDetail"},{"type":"null"}]}},"title":"Formula1Result","type":"object"},"Response762Cca4421D2_ForumData":{"description":"Defines a result from a discussion forum.","properties":{"forum_name":{"description":"The name of the forum.","title":"Forum Name","type":"string"},"num_answers":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of answers to the post.","title":"Num Answers"},"question":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The question asked in the forum post.","title":"Question"},"score":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The score of the post on the forum.","title":"Score"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The title of the post on the forum.","title":"Title"},"top_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The top-rated comment under the forum post.","title":"Top Comment"}},"required":["forum_name"],"title":"ForumData","type":"object"},"Response762Cca4421D2_GenericInfobox":{"description":"Aggregated information on a generic entity from a knowledge graph.","properties":{"attributes":{"default":[],"description":"A list of attributes about the entity.","items":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxItems":2,"minItems":2,"type":"array"},"title":"Attributes","type":"array"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Category classification for the entity.","title":"Category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"A unit representing quantity relevant to the entity."},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"found_in_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"List of URLs where the entity was found.","title":"Found In Urls"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},"type":"array"},{"type":"null"}],"description":"A list of images relevant to the entity.","title":"Images"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Any label associated with the entity.","title":"Label"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"long_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A longer description for the entity.","title":"Long Desc"},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"Any movie data relevant to the entity. Appears only when the result is a movie."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"position":{"description":"The position on a search result page.","title":"Position","type":"integer"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"profiles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},"type":"array"},{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"The profiles associated with the entity.","title":"Profiles"},"providers":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"A list of data sources for the entity.","title":"Providers"},"ratings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},"type":"array"},{"type":"null"}],"description":"Any ratings given to the entity.","title":"Ratings"},"subtype":{"const":"generic","default":"generic","description":"The infobox subtype identifier. The value is always generic.","enum":["generic"],"title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the entity."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"infobox","default":"infobox","description":"The infobox result type identifier. The value is always infobox.","enum":["infobox"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The official website pertaining to the entity.","title":"Website Url"}},"required":["title","url","position"],"title":"GenericInfobox","type":"object"},"Response762Cca4421D2_GraphInfobox":{"description":"Aggregated information on an entity shown as an infobox.","properties":{"results":{"description":"A list of infoboxes associated with the query.","items":{"discriminator":{"mapping":{"code":"#/components/schemas/Response762Cca4421D2_QAInfobox","entity":"#/components/schemas/Response762Cca4421D2_EntityInfobox","generic":"#/components/schemas/Response762Cca4421D2_GenericInfobox","location":"#/components/schemas/Response762Cca4421D2_InfoboxWithLocation","place":"#/components/schemas/Response762Cca4421D2_InfoboxPlace"},"propertyName":"subtype"},"oneOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_GenericInfobox"},{"$ref":"#/components/schemas/Response762Cca4421D2_QAInfobox"},{"$ref":"#/components/schemas/Response762Cca4421D2_InfoboxPlace"},{"$ref":"#/components/schemas/Response762Cca4421D2_InfoboxWithLocation"},{"$ref":"#/components/schemas/Response762Cca4421D2_EntityInfobox"}]},"title":"Results","type":"array"},"type":{"const":"graph","default":"graph","description":"The type identifier for infoboxes. The value is always graph.","enum":["graph"],"title":"Type","type":"string"}},"required":["results"],"title":"GraphInfobox","type":"object"},"Response762Cca4421D2_HowTo":{"description":"Aggregated information on a how to.","properties":{"image":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of image URLs associated with the how to.","title":"Image"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A name for the how to.","title":"Name"},"text":{"description":"The how to text.","title":"Text","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A URL associated with the how to.","title":"Url"}},"required":["text"],"title":"HowTo","type":"object"},"Response762Cca4421D2_Image":{"description":"A model describing an image.","properties":{"properties":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_ImageProperties"},{"type":"null"}],"description":"Metadata on the image."},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"The thumbnail associated with the image."},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The URL of the image.","title":"Url"}},"required":["thumbnail"],"title":"Image","type":"object"},"Response762Cca4421D2_ImageProperties":{"description":"Metadata on an image.","properties":{"content_size":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The image size.","title":"Content Size"},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The image format.","title":"Format"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The image height.","title":"Height"},"placeholder":{"description":"The placeholder image URL.","title":"Placeholder","type":"string"},"resized":{"description":"The URL for a better quality resized image.","title":"Resized","type":"string"},"url":{"description":"The original image URL.","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The image width.","title":"Width"}},"required":["url","resized","placeholder"],"title":"ImageProperties","type":"object"},"Response762Cca4421D2_ImageResult":{"properties":{"confidence":{"anyOf":[{"enum":["low","medium","high"],"type":"string"},{"type":"null"}],"description":"The confidence level for the image result.","title":"Confidence"},"meta_url":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__images__MetaUrl"},{"type":"null"}],"description":"Aggregated information on the URL associated with the image search result."},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ.","title":"Page Fetched"},"properties":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Properties"},{"type":"null"}],"description":"Metadata for the image."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The source domain where the image was found.","title":"Source"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__images__Thumbnail"},{"type":"null"}],"description":"The thumbnail for the image."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The title of the image.","title":"Title"},"type":{"default":"image_result","description":"The type of image search API result. The value is always image_result.","title":"Type","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The original page URL where the image was found.","title":"Url"}},"title":"ImageResult","type":"object"},"Response762Cca4421D2_ImageSearchApiResponse":{"properties":{"extra":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__images__Extra","description":"Additional information about the image search results."},"query":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__images__Query","description":"Image search query string."},"results":{"description":"The list of image results for the given query.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_ImageResult"},"title":"Results","type":"array"},"type":{"const":"images","default":"images","enum":["images"],"title":"Type","type":"string"}},"required":["query","results","extra"],"title":"ImageSearchApiResponse","type":"object"},"Response762Cca4421D2_Info":{"properties":{"rate":{"title":"Rate","type":"number"},"timestamp":{"title":"Timestamp","type":"integer"}},"required":["rate","timestamp"],"title":"Info","type":"object"},"Response762Cca4421D2_InfoboxPlace":{"description":"An infobox for a place, such as a business.","properties":{"attributes":{"default":[],"description":"A list of attributes about the entity.","items":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxItems":2,"minItems":2,"type":"array"},"title":"Attributes","type":"array"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Category classification for the entity.","title":"Category"},"coordinates":{"anyOf":[{"maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array"},{"type":"null"}],"description":"The coordinates of the location.","title":"Coordinates"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"A unit representing quantity relevant to the entity."},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"found_in_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"List of URLs where the entity was found.","title":"Found In Urls"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},"type":"array"},{"type":"null"}],"description":"A list of images relevant to the entity.","title":"Images"},"is_location":{"default":false,"description":"Whether the entity is a location.","title":"Is Location","type":"boolean"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Any label associated with the entity.","title":"Label"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"location":{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult","description":"The location result."},"long_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A longer description for the entity.","title":"Long Desc"},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"Any movie data relevant to the entity. Appears only when the result is a movie."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"position":{"description":"The position on a search result page.","title":"Position","type":"integer"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"profiles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},"type":"array"},{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"The profiles associated with the entity.","title":"Profiles"},"providers":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"A list of data sources for the entity.","title":"Providers"},"ratings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},"type":"array"},{"type":"null"}],"description":"Any ratings given to the entity.","title":"Ratings"},"subtype":{"const":"place","default":"place","description":"The infobox subtype identifier. The value is always place.","enum":["place"],"title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the entity."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"infobox","default":"infobox","description":"The infobox result type identifier. The value is always infobox.","enum":["infobox"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The official website pertaining to the entity.","title":"Website Url"},"zoom_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The map zoom level.","title":"Zoom Level"}},"required":["title","url","position","location"],"title":"InfoboxPlace","type":"object"},"Response762Cca4421D2_InfoboxWithLocation":{"description":"An infobox with location.","properties":{"attributes":{"default":[],"description":"A list of attributes about the entity.","items":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxItems":2,"minItems":2,"type":"array"},"title":"Attributes","type":"array"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Category classification for the entity.","title":"Category"},"coordinates":{"anyOf":[{"maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array"},{"type":"null"}],"description":"The coordinates of the location.","title":"Coordinates"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"A unit representing quantity relevant to the entity."},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"found_in_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"List of URLs where the entity was found.","title":"Found In Urls"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},"type":"array"},{"type":"null"}],"description":"A list of images relevant to the entity.","title":"Images"},"is_location":{"default":false,"description":"Whether the entity is a location.","title":"Is Location","type":"boolean"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Any label associated with the entity.","title":"Label"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"location":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},{"type":"null"}],"description":"The location result."},"long_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A longer description for the entity.","title":"Long Desc"},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"Any movie data relevant to the entity. Appears only when the result is a movie."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"position":{"description":"The position on a search result page.","title":"Position","type":"integer"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"profiles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},"type":"array"},{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"The profiles associated with the entity.","title":"Profiles"},"providers":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"A list of data sources for the entity.","title":"Providers"},"ratings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},"type":"array"},{"type":"null"}],"description":"Any ratings given to the entity.","title":"Ratings"},"subtype":{"const":"location","default":"location","description":"The infobox subtype identifier. The value is always location.","enum":["location"],"title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the entity."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"infobox","default":"infobox","description":"The infobox result type identifier. The value is always infobox.","enum":["infobox"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The official website pertaining to the entity.","title":"Website Url"},"zoom_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The map zoom level.","title":"Zoom Level"}},"required":["title","url","position"],"title":"InfoboxWithLocation","type":"object"},"Response762Cca4421D2_LLMContext":{"description":"Container for all LLM context content by type.","properties":{"generic":{"default":[],"description":"Array of LLM context items with extracted web content.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_LLMContextItem"},"title":"Generic","type":"array"},"map":{"default":[],"description":"Map/place results. When enable_local is enabled, the response may include map data.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_LLMContextMapItem"},"title":"Map","type":"array"},"poi":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LLMContextPOIItem"},{"type":"null"}],"description":"Point of interest data. When enable_local is enabled, the response may include POI data."}},"title":"LLMContext","type":"object"},"Response762Cca4421D2_LLMContextAPIResponse":{"description":"Response model for the LLM Context API (/v1/llm/context).","properties":{"grounding":{"$ref":"#/components/schemas/Response762Cca4421D2_LLMContext","default":{"generic":[],"map":[]}},"sources":{"additionalProperties":{"$ref":"#/components/schemas/Response762Cca4421D2_Source"},"default":{},"description":"Metadata for all referenced URLs, keyed by URL.","title":"Sources","type":"object"}},"title":"LLMContextAPIResponse","type":"object"},"Response762Cca4421D2_LLMContextItem":{"description":"A single LLM context item with URL, title, snippets, and optional last modified dates.","properties":{"snippets":{"default":[],"description":"Extracted text chunks from the page that are picked for their relevance to the query.","items":{"type":"string"},"title":"Snippets","type":"array"},"title":{"default":"","description":"The page title.","title":"Title","type":"string"},"url":{"default":"","description":"The source URL.","title":"Url","type":"string"}},"title":"LLMContextItem","type":"object"},"Response762Cca4421D2_LLMContextMapItem":{"description":"A map/place item returned in the map array for local recall queries.","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the place.","title":"Name"},"snippets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The snippets about the place.","title":"Snippets"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The title of the place.","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The URL of the place.","title":"Url"}},"title":"LLMContextMapItem","type":"object"},"Response762Cca4421D2_LLMContextPOIItem":{"description":"A point of interest item returned in the poi array for local recall queries.","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the point of interest.","title":"Name"},"snippets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The snippets about the point of interest.","title":"Snippets"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The title of the point of interest.","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The URL of the point of interest.","title":"Url"}},"title":"LLMContextPOIItem","type":"object"},"Response762Cca4421D2_LocalDescriptionsSearchApiResponse":{"properties":{"results":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationDescription"},{"type":"null"}]},"type":"array"},{"type":"null"}],"description":"The list of location descriptions for the given location identifiers.","title":"Results"},"type":{"const":"local_descriptions","default":"local_descriptions","enum":["local_descriptions"],"title":"Type","type":"string"}},"title":"LocalDescriptionsSearchApiResponse","type":"object"},"Response762Cca4421D2_LocalPlaceSearchApiResponse":{"properties":{"addresses":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_AddressResult"},"type":"array"},{"type":"null"}],"description":"The list of address results for the given query.","title":"Addresses"},"cities":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_CityResult"},"type":"array"},{"type":"null"}],"description":"The list of city results for the given query.","title":"Cities"},"countries":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_CountryResult"},"type":"array"},{"type":"null"}],"description":"The list of country results for the given query.","title":"Countries"},"location":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__search_api__responses__local__v1__Location"},{"type":"null"}],"description":"Information about location resolved from either the coordinates of the location string."},"mixed":{"default":[],"description":"The list of mixed results for the given query.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_ResultReference"},"title":"Mixed","type":"array"},"neighborhoods":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_NeighborhoodResult"},"type":"array"},{"type":"null"}],"description":"The list of neighborhood results for the given query.","title":"Neighborhoods"},"query":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__search_api__responses__local__v1__Query"},{"type":"null"}],"description":"The query object containing the original and potentially spell-corrected query."},"regions":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_RegionResult"},"type":"array"},{"type":"null"}],"description":"The list of region results for the given query.","title":"Regions"},"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},"type":"array"},{"type":"null"}],"description":"The list of points of interest results for the given quer.","title":"Results"},"streets":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_AddressResult"},"type":"array"},{"type":"null"}],"description":"The list of street results for the given query.","title":"Streets"},"type":{"const":"locations","default":"locations","enum":["locations"],"title":"Type","type":"string"}},"title":"LocalPlaceSearchApiResponse","type":"object"},"Response762Cca4421D2_LocalPoiSearchApiResponse":{"properties":{"results":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},{"type":"null"}]},"type":"array"},{"type":"null"}],"description":"The list of location results (POIs) for the given location identifiers.","title":"Results"},"type":{"const":"local_pois","default":"local_pois","enum":["local_pois"],"title":"Type","type":"string"}},"title":"LocalPoiSearchApiResponse","type":"object"},"Response762Cca4421D2_LocationDescription":{"description":"AI generated description of a location result.","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"AI generated description of the location with the given id.","title":"Description"},"id":{"description":"A temporary id of the location with this description.","title":"Id","type":"string"},"type":{"const":"local_description","default":"local_description","description":"The type of a location description. The value is always local_description.","enum":["local_description"],"title":"Type","type":"string"}},"required":["id"],"title":"LocationDescription","type":"object"},"Response762Cca4421D2_LocationResult":{"description":"A result that is location relevant.","properties":{"action":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Action"},{"type":"null"}],"description":"An action to be taken."},"categories":{"default":[],"description":"A list of categories.","items":{"type":"string"},"title":"Categories","type":"array"},"contact":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Contact"},{"type":"null"}],"description":"The contact of the business associated with the location."},"coordinates":{"anyOf":[{"maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array"},{"type":"null"}],"description":"A list of coordinates associated with the location. This is a lat long represented as a floating point.","title":"Coordinates"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"The distance of the location from the client."},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"icon_category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"An icon category.","title":"Icon Category"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A temporary id associated with this result, which can be used to retrieve extra information about the location. It remains valid for 8 hours.","title":"Id"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"opening_hours":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_OpeningHours"},{"type":"null"}],"description":"The opening hours, if it is a business, associated with the location."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"pictures":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_PictureResults"},{"type":"null"}],"description":"A bunch of pictures associated with the business."},"postal_address":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_PostalAddress"},{"type":"null"}],"description":"The postal address associated with the location."},"price_range":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A display string used to show the price classification for the business.","title":"Price Range"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"profiles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"Profiles associated with the business.","title":"Profiles"},"provider_url":{"description":"The complete URL of the provider.","title":"Provider Url","type":"string"},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"The ratings of the business."},"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_LocationWebResult"},"type":"array"},{"type":"null"}],"description":"Web results related to this location.","title":"Results"},"reviews":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Reviews"},{"type":"null"}],"description":"Aggregated reviews from various sources relevant to the business."},"serves_cuisine":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of cuisine categories served.","title":"Serves Cuisine"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the location."},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IANA timezone identifier.","title":"Timezone"},"timezone_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The UTC offset of the timezone.","title":"Timezone Offset"},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"location_result","default":"location_result","description":"Location result type identifier. The value is always location_result.","enum":["location_result"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"zoom_level":{"default":7,"description":"The zoom level on the map.","title":"Zoom Level","type":"integer"}},"required":["title","url","provider_url"],"title":"LocationResult","type":"object"},"Response762Cca4421D2_LocationWebResult":{"description":"A model representing a web result related to a location.","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"meta_url":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__MetaUrl","description":"Aggregated information about the URL."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"}},"required":["title","url","meta_url"],"title":"LocationWebResult","type":"object"},"Response762Cca4421D2_Locations":{"description":"A model representing location results.","properties":{"provider":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"The provider of the location data.","title":"Provider"},"results":{"description":"An aggregated list of location sensitive results.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},"title":"Results","type":"array"},"type":{"const":"locations","default":"locations","description":"Location type identifier. The value is always locations.","enum":["locations"],"title":"Type","type":"string"}},"required":["results"],"title":"Locations","type":"object"},"Response762Cca4421D2_MixedResponse":{"description":"The ranking order of results on a search result page.","properties":{"main":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_ResultReference"},"type":"array"},{"type":"null"}],"description":"The ranking order for the main section of the search result page.","title":"Main"},"side":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_ResultReference"},"type":"array"},{"type":"null"}],"description":"The ranking order for the side section of the search result page.","title":"Side"},"top":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_ResultReference"},"type":"array"},{"type":"null"}],"description":"The ranking order for the top section of the search result page.","title":"Top"},"type":{"const":"mixed","default":"mixed","description":"The type representing the model mixed. The value is always mixed.","enum":["mixed"],"title":"Type","type":"string"}},"title":"MixedResponse","type":"object"},"Response762Cca4421D2_MovieData":{"description":"Aggregated data for a movie result.","properties":{"actors":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Person"},"type":"array"},{"type":"null"}],"description":"A list of actors in the movie.","title":"Actors"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A short plot summary for the movie.","title":"Description"},"directors":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Person"},"type":"array"},{"type":"null"}],"description":"A list of people responsible for directing the movie.","title":"Directors"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The runtime of the movie. The format is HH:MM:SS.","title":"Duration"},"genre":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"List of genres in which the movie can be classified.","title":"Genre"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Name of the movie.","title":"Name"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The query that resulted in the movie result.","title":"Query"},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"Rating provided to the movie from various sources."},"release":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The release date for the movie.","title":"Release"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"A thumbnail for a movie poster."},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A URL serving a movie profile page.","title":"Url"}},"title":"MovieData","type":"object"},"Response762Cca4421D2_MusicRecording":{"description":"Result classified as a music label or a song.","properties":{"name":{"description":"The name of the song or album.","minLength":1,"title":"Name","type":"string"},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"The rating of the music."},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"A thumbnail associated with the music."}},"required":["name"],"title":"MusicRecording","type":"object"},"Response762Cca4421D2_NeighborhoodResult":{"description":"A result representing a neighborhood.","properties":{"coordinates":{"description":"A pair of coordinates (lat, long) for the neighborhood.","maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"title":"Coordinates","type":"array"},"country":{"description":"The country of the neighborhood.","title":"Country","type":"string"},"name":{"description":"The name of the neighborhood.","title":"Name","type":"string"},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"Primary image for the neighborhood."},"type":{"const":"neighborhood","default":"neighborhood","description":"Neighborhood result type identifier. The value is always neighborhood.","enum":["neighborhood"],"title":"Type","type":"string"}},"required":["name","country","coordinates","thumbnail"],"title":"NeighborhoodResult","type":"object"},"Response762Cca4421D2_News":{"properties":{"mutated_by_goggles":{"default":false,"description":"Whether the results are mutated by a goggle.","title":"Mutated By Goggles","type":"boolean"},"results":{"description":"The list of news results.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__NewsResult"},"title":"Results","type":"array"},"type":{"const":"news","default":"news","description":"The type of API result. The value is always news.","enum":["news"],"title":"Type","type":"string"}},"required":["results"],"title":"News","type":"object"},"Response762Cca4421D2_NewsSearchApiResponse":{"properties":{"query":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__news__Query","description":"News search query string."},"results":{"default":[],"description":"The list of news results for the given query.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__news__NewsResult"},"title":"Results","type":"array"},"type":{"const":"news","default":"news","enum":["news"],"title":"Type","type":"string"}},"required":["query"],"title":"NewsSearchApiResponse","type":"object"},"Response762Cca4421D2_NowToDate":{"properties":{"intent_type":{"const":"now_to_date","default":"now_to_date","enum":["now_to_date"],"title":"Intent Type","type":"string"}},"title":"NowToDate","type":"object"},"Response762Cca4421D2_NowToTs":{"properties":{"intent_type":{"const":"now_to_ts","default":"now_to_ts","enum":["now_to_ts"],"title":"Intent Type","type":"string"}},"title":"NowToTs","type":"object"},"Response762Cca4421D2_OpenAIChatResponse":{"properties":{"choices":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_ChoiceChunk"},"title":"Choices","type":"array"},"created":{"title":"Created","type":"integer"},"id":{"title":"Id","type":"string"},"model":{"default":"brave-pro","enum":["brave-pro","brave"],"title":"Model","type":"string"},"object":{"const":"chat.completion.chunk","default":"chat.completion.chunk","enum":["chat.completion.chunk"],"title":"Object","type":"string"},"system_fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Fingerprint"},"usage":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_OpenAIUsage"},{"type":"null"}]}},"required":["choices","created","id"],"title":"OpenAIChatResponse","type":"object"},"Response762Cca4421D2_OpenAICompletionTokensDetails":{"properties":{"reasoning_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reasoning Tokens"}},"title":"OpenAICompletionTokensDetails","type":"object"},"Response762Cca4421D2_OpenAIUsage":{"properties":{"completion_tokens":{"title":"Completion Tokens","type":"integer"},"completion_tokens_details":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_OpenAICompletionTokensDetails"},{"type":"null"}]},"prompt_tokens":{"title":"Prompt Tokens","type":"integer"},"total_tokens":{"title":"Total Tokens","type":"integer"}},"required":["completion_tokens","prompt_tokens","total_tokens"],"title":"OpenAIUsage","type":"object"},"Response762Cca4421D2_OpeningHours":{"description":"Opening hours of a business at a particular location.","properties":{"current_day":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_DayOpeningHours"},"type":"array"},{"type":"null"}],"description":"The current day opening hours. Can have two sets of opening hours.","title":"Current Day"},"days":{"anyOf":[{"items":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_DayOpeningHours"},"type":"array"},"type":"array"},{"type":"null"}],"description":"The opening hours for the whole week.","title":"Days"}},"title":"OpeningHours","type":"object"},"Response762Cca4421D2_Organization":{"description":"An entity responsible for another entity.","properties":{"contact_points":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_ContactPoint"},"type":"array"},{"type":"null"}],"description":"A list of contact points for the organization.","title":"Contact Points"},"name":{"description":"The name of the thing.","title":"Name","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"Thumbnail associated with the thing."},"type":{"default":"organization","description":"A type string identifying an organization. The value is always organization.","title":"Type","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A URL for the thing.","title":"Url"}},"required":["name"],"title":"Organization","type":"object"},"Response762Cca4421D2_OriginalQuery":{"properties":{"original":{"description":"The original query that was requested.","title":"Original","type":"string"}},"required":["original"],"title":"OriginalQuery","type":"object"},"Response762Cca4421D2_PackageTrackerResult":{"properties":{"matched":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_TrackingNumber"},"title":"Matched","type":"array"}},"title":"PackageTrackerResult","type":"object"},"Response762Cca4421D2_Person":{"description":"A model describing a person entity.","properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Email address of the person.","title":"Email"},"name":{"description":"The name of the thing.","title":"Name","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"Thumbnail associated with the thing."},"type":{"const":"person","default":"person","description":"A type identifying a person. The value is always person.","enum":["person"],"title":"Type","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A URL for the thing.","title":"Url"}},"required":["name"],"title":"Person","type":"object"},"Response762Cca4421D2_PictureResults":{"description":"A model representing a list of pictures.","properties":{"results":{"description":"A list of thumbnail results.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},"title":"Results","type":"array"},"viewMoreUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A URL to view more pictures.","title":"Viewmoreurl"}},"required":["viewMoreUrl","results"],"title":"PictureResults","type":"object"},"Response762Cca4421D2_PostalAddress":{"description":"A model representing a postal address of a location.","properties":{"addressLocality":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The address locality or subregion associated with the location.","title":"Addresslocality"},"addressRegion":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The region associated with the location. This is usually a state.","title":"Addressregion"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The country associated with the location.","title":"Country"},"displayAddress":{"description":"The displayed address string.","title":"Displayaddress","type":"string"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The postal code associated with the location.","title":"Postalcode"},"streetAddress":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The street address associated with the location.","title":"Streetaddress"},"type":{"const":"PostalAddress","default":"PostalAddress","description":"The type identifying a postal address. The value is always PostalAddress.","enum":["PostalAddress"],"title":"Type","type":"string"}},"required":["displayAddress"],"title":"PostalAddress","type":"object"},"Response762Cca4421D2_PostprocessedIcon":{"properties":{"ext":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ext"},"href":{"title":"Href","type":"string"},"rel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rel"},"sizes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sizes"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"required":["href","sizes","rel","type","ext"],"title":"PostprocessedIcon","type":"object"},"Response762Cca4421D2_Price":{"description":"A model representing the price for an entity.","properties":{"price":{"description":"The price value in a given currency.","title":"Price","type":"string"},"priceCurrency":{"description":"The currency of the price value.","title":"Pricecurrency","type":"string"}},"required":["price","priceCurrency"],"title":"Price","type":"object"},"Response762Cca4421D2_Properties":{"properties":{"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the image.","title":"Height"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The lower resolution placeholder image URL.","title":"Placeholder"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The image URL.","title":"Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the image.","title":"Width"}},"title":"Properties","type":"object"},"Response762Cca4421D2_QA":{"description":"A question/answer result.","properties":{"answer":{"description":"The answer to the question.","title":"Answer","type":"string"},"meta_url":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__MetaUrl"},{"type":"null"}],"description":"Aggregated information about the URL."},"question":{"description":"The question being asked.","title":"Question","type":"string"},"title":{"description":"The title of the post.","title":"Title","type":"string"},"url":{"description":"The URL pointing to the post.","title":"Url","type":"string"}},"required":["question","answer","title","url"],"title":"QA","type":"object"},"Response762Cca4421D2_QAInfobox":{"description":"A question answer infobox.","properties":{"attributes":{"default":[],"description":"A list of attributes about the entity.","items":{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxItems":2,"minItems":2,"type":"array"},"title":"Attributes","type":"array"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Category classification for the entity.","title":"Category"},"data":{"$ref":"#/components/schemas/Response762Cca4421D2_QAPage","description":"The question and relevant answer."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"distance":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Unit"},{"type":"null"}],"description":"A unit representing quantity relevant to the entity."},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"images":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},"type":"array"},{"type":"null"}],"description":"A list of images relevant to the entity.","title":"Images"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Any label associated with the entity.","title":"Label"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"long_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A longer description for the entity.","title":"Long Desc"},"meta_url":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__MetaUrl"},{"type":"null"}],"description":"Detailed information on the page containing the question and relevant answer."},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"Any movie data relevant to the entity. Appears only when the result is a movie."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"position":{"description":"The position on a search result page.","title":"Position","type":"integer"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"profiles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},"type":"array"},{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"The profiles associated with the entity.","title":"Profiles"},"providers":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider"},"type":"array"},{"type":"null"}],"description":"A list of data sources for the entity.","title":"Providers"},"ratings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},"type":"array"},{"type":"null"}],"description":"Any ratings given to the entity.","title":"Ratings"},"subtype":{"const":"code","default":"code","description":"The infobox subtype identifier. The value is always code.","enum":["code"],"title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the entity."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"infobox","default":"infobox","description":"The infobox result type identifier. The value is always infobox.","enum":["infobox"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The official website pertaining to the entity.","title":"Website Url"}},"required":["title","url","position","data"],"title":"QAInfobox","type":"object"},"Response762Cca4421D2_QAPage":{"description":"Aggregated result from a question answer page.","properties":{"answer":{"$ref":"#/components/schemas/Response762Cca4421D2_Answer","description":"An answer to the question."},"question":{"description":"The question that is being asked.","title":"Question","type":"string"}},"required":["question","answer"],"title":"QAPage","type":"object"},"Response762Cca4421D2_Recipe":{"description":"Aggregated information on a recipe.","properties":{"calories":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Calorie count for the recipe.","title":"Calories"},"cook_time":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The cooking time for the recipe.","title":"Cook Time"},"description":{"description":"The description of the recipe.","title":"Description","type":"string"},"domain":{"description":"The domain of the web page where the recipe was found.","title":"Domain","type":"string"},"favicon":{"description":"The URL for the favicon of the web page where the recipe was found.","title":"Favicon","type":"string"},"ingredients":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ingredients required for the recipe.","title":"Ingredients"},"instructions":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_HowTo"},"type":"array"},{"type":"null"}],"description":"List of instructions for the recipe.","title":"Instructions"},"prep_time":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The preparation time for the recipe.","title":"Prep Time"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The publisher of the recipe.","title":"Publisher"},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"Aggregated information on the ratings associated with the recipe."},"recipeCategory":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The category of the recipe.","title":"Recipecategory"},"recipeCuisine":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The cuisine classification for the recipe.","title":"Recipecuisine"},"servings":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"How many people the recipe serves.","title":"Servings"},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"A thumbnail associated with the recipe."},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The total time required to cook the recipe.","title":"Time"},"title":{"description":"The title of the recipe.","title":"Title","type":"string"},"url":{"description":"The URL of the web page where the recipe was found.","title":"Url","type":"string"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__VideoData"},{"type":"null"}],"description":"Aggregated information on the cooking video associated with the recipe."}},"required":["title","description","thumbnail","url","domain","favicon"],"title":"Recipe","type":"object"},"Response762Cca4421D2_RegionResult":{"description":"A result representing a region (e.g. a state or province).","properties":{"coordinates":{"description":"A pair of coordinates (lat, long) for the region.","maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"title":"Coordinates","type":"array"},"country":{"description":"The country of the region.","title":"Country","type":"string"},"name":{"description":"The name of the region.","title":"Name","type":"string"},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"Primary image for the region."},"type":{"const":"region","default":"region","description":"Region result type identifier. The value is always region.","enum":["region"],"title":"Type","type":"string"}},"required":["name","country","coordinates","thumbnail"],"title":"RegionResult","type":"object"},"Response762Cca4421D2_ResponseCallback":{"properties":{"callback_key":{"description":"The unique key for the callback.","title":"Callback Key","type":"string"},"vertical":{"$ref":"#/components/schemas/Response762Cca4421D2_SearchAPIVertical","description":"The vertical associated with the callback. For the full list of verticals supported see the Rich Vertical list."}},"required":["vertical","callback_key"],"title":"ResponseCallback","type":"object"},"Response762Cca4421D2_ResponseCallbackInfo":{"properties":{"callback_key":{"description":"The unique key for the callback.","title":"Callback Key","type":"string"},"callback_status":{"description":"The status of the callback operation. The value is either success or failure.","enum":["success","failure"],"title":"Callback Status","type":"string"},"search_lang":{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__mixer__general__Language","default":"en","description":"The language used for the search."},"vertical":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SearchAPIVertical"},{"type":"null"}],"description":"The vertical associated with the callback. For the full list of verticals supported see the Rich Vertical list."}},"required":["callback_key","callback_status"],"title":"ResponseCallbackInfo","type":"object"},"Response762Cca4421D2_Result":{"description":"A model representing a web search result.","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"}},"required":["title","url"],"title":"Result","type":"object"},"Response762Cca4421D2_ResultReference":{"description":"The ranking order of results on a search result page.","properties":{"all":{"default":false,"description":"Whether to put all the results from the type at specific position.","title":"All","type":"boolean"},"index":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The 0th based index where the result should be placed.","title":"Index"},"type":{"description":"The type of the result.","title":"Type","type":"string"}},"required":["type"],"title":"ResultReference","type":"object"},"Response762Cca4421D2_Review":{"description":"A model representing a review for an entity.","properties":{"description":{"description":"A description of the review (the text of the review itself).","title":"Description","type":"string"},"name":{"description":"The review title for the review.","title":"Name","type":"string"},"rating":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating","description":"The ratings associated with the review."},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"The thumbnail associated with the reviewer."},"type":{"const":"Review","default":"Review","description":"A string representing review type. This is always Review.","enum":["Review"],"title":"Type","type":"string"}},"required":["name","thumbnail","description","rating"],"title":"Review","type":"object"},"Response762Cca4421D2_Reviews":{"description":"The reviews associated with an entity.","properties":{"results":{"description":"A list of trip advisor reviews for the entity.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_TripadvisorReview"},"title":"Results","type":"array"},"reviews_in_foreign_language":{"description":"Any reviews available in a foreign language.","title":"Reviews In Foreign Language","type":"boolean"},"viewMoreUrl":{"description":"A URL to a web page where more information on the result can be seen.","title":"Viewmoreurl","type":"string"}},"required":["results","viewMoreUrl","reviews_in_foreign_language"],"title":"Reviews","type":"object"},"Response762Cca4421D2_RichHeaderCallback":{"properties":{"hint":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_ResponseCallback"},{"type":"null"}]},"type":{"const":"rich","default":"rich","enum":["rich"],"title":"Type","type":"string"}},"title":"RichHeaderCallback","type":"object"},"Response762Cca4421D2_RichHeaderResponse":{"properties":{"response_callback_info":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_ResponseCallbackInfo"},{"type":"null"}]},"results":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_RichResult"},"title":"Results","type":"array"},"type":{"const":"rich","default":"rich","enum":["rich"],"title":"Type","type":"string"}},"title":"RichHeaderResponse","type":"object"},"Response762Cca4421D2_RichResult":{"properties":{"american_football":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsResultAmericanFootball"},{"type":"null"}]},"baseball":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsResultBaseball"},{"type":"null"}]},"basketball":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsResultBasketball"},{"type":"null"}]},"calculator":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_CalculatorResult"},{"type":"null"}]},"cricket":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsResultCricket"},{"type":"null"}]},"cryptocurrency":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_CryptocurrencyResult"},{"type":"null"}]},"currency":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_CurrencyResult"},{"type":"null"}]},"definitions":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_DefinitionsResult"},{"type":"null"}]},"football":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsResultFootball"},{"type":"null"}]},"formula1":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Formula1Result"},{"type":"null"}]},"ice_hockey":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsResultIceHockey"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"news":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_TopStoriesNewsResult"},{"type":"null"}]},"packagetracker":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_PackageTrackerResult"},{"type":"null"}]},"provider":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__mixer__specs__items__DataProvider"},{"type":"null"}]},"stock":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_StockResult"},{"type":"null"}]},"subtype":{"$ref":"#/components/schemas/Response762Cca4421D2_SearchAPIVertical"},"type":{"const":"rich","default":"rich","enum":["rich"],"title":"Type","type":"string"},"unitconversion":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_UnitConversionResult"},{"type":"null"}]},"unixtimestamp":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_UnixTimestampResult"},{"type":"null"}]},"weather":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_WeatherResult"},{"type":"null"}]}},"required":["subtype"],"title":"RichResult","type":"object"},"Response762Cca4421D2_Search":{"description":"A model representing a collection of web search results.","properties":{"family_friendly":{"default":true,"description":"Whether the results are family friendly.","title":"Family Friendly","type":"boolean"},"results":{"description":"A list of search results.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_SearchResult"},"title":"Results","type":"array"},"type":{"const":"search","default":"search","description":"A type identifying web search results. The value is always search.","enum":["search"],"title":"Type","type":"string"}},"required":["results"],"title":"Search","type":"object"},"Response762Cca4421D2_SearchAPIVertical":{"enum":["calculator","cryptocurrency","currency","definitions","formula1","packagetracker","sports","stocks","unitconversion","unixtimestamp","weather"],"title":"SearchAPIVertical","type":"string"},"Response762Cca4421D2_SearchOperators":{"properties":{"applied":{"default":false,"description":"Whether search operators were applied to the query.","title":"Applied","type":"boolean"},"cleaned_query":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The query after search operators have been processed.","title":"Cleaned Query"},"sites":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"List of site domains extracted from site: operators.","title":"Sites"}},"title":"SearchOperators","type":"object"},"Response762Cca4421D2_SearchResult":{"description":"Aggregated information on a web search result, relevant to the query.","properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A human-readable representation of the web search result’s age. For example, 2 days ago.","title":"Age"},"article":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Article"},{"type":"null"}],"description":"An article found for the web search result page."},"book":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Book"},{"type":"null"}],"description":"Any book information associated with the web search result page."},"cluster":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Result"},"type":"array"},{"type":"null"}],"description":"A list of web search results.","title":"Cluster"},"cluster_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A type representing a cluster. The value can be product_cluster.","title":"Cluster Type"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The content type associated with the search result page.","title":"Content Type"},"creative_work":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_CreativeWork"},{"type":"null"}],"description":"Aggregated information on the creative work found on the web search result."},"deep_results":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_DeepResult"},{"type":"null"}],"description":"Gathered information on a web search result."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"extra_snippets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of extra alternate snippets for the web search result.","title":"Extra Snippets"},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"faq":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__FAQ"},{"type":"null"}],"description":"Any frequently asked questions associated with the web search result."},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"icons":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_PostprocessedIcon"},"type":"array"},{"type":"null"}],"description":"Icons associated with the search result.","title":"Icons"},"is_live":{"default":false,"description":"Whether the web search result is currently live. Default value is false.","title":"Is Live","type":"boolean"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"default":"en","description":"The main language on the web search result.","title":"Language","type":"string"},"location":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},{"type":"null"}],"description":"The location details if the query relates to a restaurant."},"meta_url":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Aggregated information on the URL associated with the web search result.","title":"Meta Url"},"movie":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MovieData"},{"type":"null"}],"description":"The movie associated with the web search result."},"music_recording":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_MusicRecording"},{"type":"null"}],"description":"Aggregated information on music recording found on the web search result."},"organization":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Organization"},{"type":"null"}],"description":"Aggregated information on a organization found on the web search result page."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"product":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Product"},{"$ref":"#/components/schemas/Response762Cca4421D2_Review"},{"type":"null"}],"description":"The main product and a review that is found on the web search result page.","title":"Product"},"product_cluster":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Product"},{"$ref":"#/components/schemas/Response762Cca4421D2_Review"}]},"type":"array"},{"type":"null"}],"description":"A list of products and reviews that are found on the web search result page.","title":"Product Cluster"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"qa":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_QAPage"},{"type":"null"}],"description":"Any question answer information associated with the web search result page."},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"Rating found for the web search result page."},"recipe":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Recipe"},{"type":"null"}],"description":"Aggregated information on a recipe found on the web search result page."},"restaurant":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_LocationResult"},{"type":"null"}],"deprecated":true,"description":"Deprecated. Use location instead."},"review":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Review"},{"type":"null"}],"description":"Aggregated information on the review found on the web search result."},"schemas":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"description":"A list of schemas (structured data) extracted from the page. The schemas try to follow schema.org and will return anything we can extract from the HTML that can fit into these models.","title":"Schemas"},"software":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_Software"},{"type":"null"}],"description":"Aggregated information on a software product found on the web search result page."},"subtype":{"default":"generic","description":"A sub type identifying the web search result type.","title":"Subtype","type":"string"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail of the web search result."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"search_result","default":"search_result","description":"A type identifying a web search result. The value is always search_result.","enum":["search_result"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__VideoData"},{"type":"null"}],"description":"The video associated with the web search result."}},"required":["title","url"],"title":"SearchResult","type":"object"},"Response762Cca4421D2_Software":{"description":"A model representing a software entity.","properties":{"author":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The author of software product.","title":"Author"},"codeRepository":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The code repository where the software product is currently available or maintained.","title":"Coderepository"},"datePublished":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The date when the software product was published.","title":"Datepublished"},"forks":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The numbers of forks of the repository.","title":"Forks"},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The home page of the software product.","title":"Homepage"},"is_npm":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the software product is available on npm.","title":"Is Npm"},"is_pypi":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the software product is available on pypi.","title":"Is Pypi"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the software product.","title":"Name"},"programmingLanguage":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The programming language spread on the software product.","title":"Programminglanguage"},"stars":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of stars on the repository.","title":"Stars"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The latest version of the software product.","title":"Version"}},"title":"Software","type":"object"},"Response762Cca4421D2_Source":{"description":"Minimal metadata for a referenced source URL.","properties":{"age":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The page’s date rendered four ways, in fixed positions: full date, YYYY-MM-DD, relative age, and an ISO 8601 timestamp. Empty when the page has no known date.","title":"Age"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s own description, independent of the query (unlike snippet). Requires enable_source_metadata.","title":"Description"},"favicon":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL to the site’s favicon image.","title":"Favicon"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Unix seconds of the index’s last fetch of this page. Requires enable_source_metadata.","title":"Fetched Content Timestamp"},"hostname":{"default":"","description":"The source hostname.","title":"Hostname","type":"string"},"robotstxt_status":{"anyOf":[{"enum":["allow","disallow","unknown"],"type":"string"},{"type":"null"}],"description":"Robots.txt status for the requested user-agent: allow, disallow, or unknown.","title":"Robotstxt Status"},"site_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The site name (e.g. ‘Wikipedia’).","title":"Site Name"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The most query-relevant passage of the source page.","title":"Snippet"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__search_api__specs__atomic__Thumbnail"},{"type":"null"}],"description":"Page thumbnail: src is the proxied URL (ready to serve); original is the raw upstream URL."},"title":{"default":"","description":"The page title.","title":"Title","type":"string"}},"title":"Source","type":"object"},"Response762Cca4421D2_SpellCheckResult":{"properties":{"query":{"description":"The spellcheck-corrected query.","title":"Query","type":"string"}},"required":["query"],"title":"SpellCheckResult","type":"object"},"Response762Cca4421D2_SpellCheckSearchApiResponse":{"properties":{"query":{"$ref":"#/components/schemas/Response762Cca4421D2_OriginalQuery","description":"Spellcheck search query string. Only the original query is returned."},"results":{"default":[],"description":"The list of spell-checked results for given query.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_SpellCheckResult"},"title":"Results","type":"array"},"type":{"const":"spellcheck","default":"spellcheck","enum":["spellcheck"],"title":"Type","type":"string"}},"required":["query"],"title":"SpellCheckSearchApiResponse","type":"object"},"Response762Cca4421D2_SportsAmericanFootballContentFixture":{"properties":{"bulletins":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballFixtureBulletin"},"type":"array"},{"type":"null"}],"title":"Bulletins"},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Title"},"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"phase":{"title":"Phase","type":"string"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"score_table":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballScoreTable"},"start_time":{"title":"Start Time","type":"integer"},"statistics":{"title":"Statistics","type":"object"},"status":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballFixtureStatus"},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"type":{"const":"fixture","default":"fixture","enum":["fixture"],"title":"Type","type":"string"},"week":{"title":"Week","type":"integer"}},"required":["league","id","start_time","teams","status","score_table","statistics","phase","week"],"title":"SportsAmericanFootballContentFixture","type":"object"},"Response762Cca4421D2_SportsAmericanFootballContentLeagueGames":{"properties":{"date":{"title":"Date","type":"string"},"date_kind":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDateKind"},"game_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Game Time"},"game_times":{"items":{"type":"integer"},"title":"Game Times","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureAmericanFootball"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_games","default":"league_games","enum":["league_games"],"title":"Type","type":"string"}},"required":["league","game_times","date","date_kind","games"],"title":"SportsAmericanFootballContentLeagueGames","type":"object"},"Response762Cca4421D2_SportsAmericanFootballContentLeagueStandings":{"properties":{"default_group":{"title":"Default Group","type":"integer"},"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_standings","default":"league_standings","enum":["league_standings"],"title":"Type","type":"string"}},"required":["league","group_standings","default_group"],"title":"SportsAmericanFootballContentLeagueStandings","type":"object"},"Response762Cca4421D2_SportsAmericanFootballContentTeamGames":{"properties":{"competitions":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCompetition"},"title":"Competitions","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureAmericanFootball"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_games","default":"team_games","enum":["team_games"],"title":"Type","type":"string"}},"required":["league","team","games","competitions"],"title":"SportsAmericanFootballContentTeamGames","type":"object"},"Response762Cca4421D2_SportsAmericanFootballContentTeamStandings":{"properties":{"default_group":{"title":"Default Group","type":"integer"},"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_standings","default":"team_standings","enum":["team_standings"],"title":"Type","type":"string"}},"required":["league","team","group_standings","default_group"],"title":"SportsAmericanFootballContentTeamStandings","type":"object"},"Response762Cca4421D2_SportsAmericanFootballFixtureBulletin":{"properties":{"text":{"title":"Text","type":"string"}},"required":["text"],"title":"SportsAmericanFootballFixtureBulletin","type":"object"},"Response762Cca4421D2_SportsAmericanFootballFixtureStatus":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballFixtureStatusCode"},{"type":"null"}]},"elapsed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Elapsed"}},"title":"SportsAmericanFootballFixtureStatus","type":"object"},"Response762Cca4421D2_SportsAmericanFootballFixtureStatusCode":{"enum":["FT","AET","Q1","Q2","Q3","Q4","NS","POST","CANC","INT","DEL","LIVE","FFA","FFH","FFB"],"title":"SportsAmericanFootballFixtureStatusCode","type":"string"},"Response762Cca4421D2_SportsAmericanFootballScoreTable":{"properties":{"ot":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q1":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q2":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q3":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q4":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]}},"title":"SportsAmericanFootballScoreTable","type":"object"},"Response762Cca4421D2_SportsAmericanFootballStanding":{"properties":{"conference_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Rank"},"conference_seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Seed"},"division_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Division Rank"},"division_seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Division Seed"},"games_behind":{"title":"Games Behind","type":"string"},"matches_drawn":{"title":"Matches Drawn","type":"integer"},"matches_lost":{"title":"Matches Lost","type":"integer"},"matches_won":{"title":"Matches Won","type":"integer"},"matches_won_percent":{"title":"Matches Won Percent","type":"string"},"points_against":{"title":"Points Against","type":"integer"},"points_for":{"title":"Points For","type":"integer"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["team","matches_won","matches_drawn","matches_lost","matches_won_percent","points_for","points_against","games_behind"],"title":"SportsAmericanFootballStanding","type":"object"},"Response762Cca4421D2_SportsAmericanFootballStandingsDivision":{"properties":{"name":{"title":"Name","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballStanding"},"title":"Standings","type":"array"}},"required":["name","standings"],"title":"SportsAmericanFootballStandingsDivision","type":"object"},"Response762Cca4421D2_SportsAmericanFootballStandingsGroup":{"properties":{"group_name":{"title":"Group Name","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballStandingsDivision"},"title":"Standings","type":"array"}},"required":["group_name","standings"],"title":"SportsAmericanFootballStandingsGroup","type":"object"},"Response762Cca4421D2_SportsBaseballContentLeagueGames":{"properties":{"date":{"title":"Date","type":"string"},"date_kind":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDateKind"},"game_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Game Time"},"game_times":{"items":{"type":"integer"},"title":"Game Times","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureBaseball"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_games","default":"league_games","enum":["league_games"],"title":"Type","type":"string"}},"required":["league","game_times","date","date_kind","games"],"title":"SportsBaseballContentLeagueGames","type":"object"},"Response762Cca4421D2_SportsBaseballContentLeagueStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_standings","default":"league_standings","enum":["league_standings"],"title":"Type","type":"string"}},"required":["league","group_standings"],"title":"SportsBaseballContentLeagueStandings","type":"object"},"Response762Cca4421D2_SportsBaseballContentTeamGames":{"properties":{"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureBaseball"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_games","default":"team_games","enum":["team_games"],"title":"Type","type":"string"}},"required":["league","team","games"],"title":"SportsBaseballContentTeamGames","type":"object"},"Response762Cca4421D2_SportsBaseballContentTeamStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_standings","default":"team_standings","enum":["team_standings"],"title":"Type","type":"string"}},"required":["league","team","group_standings"],"title":"SportsBaseballContentTeamStandings","type":"object"},"Response762Cca4421D2_SportsBaseballFixtureStatus":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballFixtureStatusCode"},{"type":"null"}]}},"title":"SportsBaseballFixtureStatus","type":"object"},"Response762Cca4421D2_SportsBaseballFixtureStatusCode":{"enum":["FT","NS","POST","CANC","INTR","ABD","IN1","IN2","IN3","IN4","IN5","IN6","IN7","IN8","IN9"],"title":"SportsBaseballFixtureStatusCode","type":"string"},"Response762Cca4421D2_SportsBaseballInningScore":{"properties":{"away":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Away"},"home":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Home"}},"title":"SportsBaseballInningScore","type":"object"},"Response762Cca4421D2_SportsBaseballScoreTable":{"properties":{"errors":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"extra":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballInningScore"},{"type":"null"}]},"hits":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"innings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballInningScore"},"title":"Innings","type":"array"}},"required":["innings"],"title":"SportsBaseballScoreTable","type":"object"},"Response762Cca4421D2_SportsBaseballStanding":{"properties":{"form":{"title":"Form","type":"string"},"games_behind":{"title":"Games Behind","type":"number"},"matches_lost":{"title":"Matches Lost","type":"integer"},"matches_lost_pros":{"title":"Matches Lost Pros","type":"string"},"matches_played":{"title":"Matches Played","type":"integer"},"matches_won":{"title":"Matches Won","type":"integer"},"matches_won_pros":{"title":"Matches Won Pros","type":"string"},"rank":{"title":"Rank","type":"integer"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["team","rank","matches_played","matches_won","matches_won_pros","matches_lost","matches_lost_pros","games_behind","form"],"title":"SportsBaseballStanding","type":"object"},"Response762Cca4421D2_SportsBaseballStandingsGroup":{"properties":{"group_name":{"title":"Group Name","type":"string"},"stage":{"title":"Stage","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballStanding"},"title":"Standings","type":"array"}},"required":["group_name","standings","stage"],"title":"SportsBaseballStandingsGroup","type":"object"},"Response762Cca4421D2_SportsBasketballContentLeagueGames":{"properties":{"date":{"title":"Date","type":"string"},"date_kind":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDateKind"},"game_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Game Time"},"game_times":{"items":{"type":"integer"},"title":"Game Times","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureBasketball"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_games","default":"league_games","enum":["league_games"],"title":"Type","type":"string"}},"required":["league","game_times","date","date_kind","games"],"title":"SportsBasketballContentLeagueGames","type":"object"},"Response762Cca4421D2_SportsBasketballContentLeagueStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_standings","default":"league_standings","enum":["league_standings"],"title":"Type","type":"string"}},"required":["league","group_standings"],"title":"SportsBasketballContentLeagueStandings","type":"object"},"Response762Cca4421D2_SportsBasketballContentTeamGames":{"properties":{"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureBasketball"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_games","default":"team_games","enum":["team_games"],"title":"Type","type":"string"}},"required":["league","team","games"],"title":"SportsBasketballContentTeamGames","type":"object"},"Response762Cca4421D2_SportsBasketballContentTeamStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_standings","default":"team_standings","enum":["team_standings"],"title":"Type","type":"string"}},"required":["league","team","group_standings"],"title":"SportsBasketballContentTeamStandings","type":"object"},"Response762Cca4421D2_SportsBasketballFixtureStatus":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballFixtureStatusCode"},{"type":"null"}]}},"title":"SportsBasketballFixtureStatus","type":"object"},"Response762Cca4421D2_SportsBasketballFixtureStatusCode":{"enum":["FT","AOT","NS","POST","CANC","SUSP","Q1","Q2","Q3","Q4","BT","OT","HT"],"title":"SportsBasketballFixtureStatusCode","type":"string"},"Response762Cca4421D2_SportsBasketballScoreTable":{"properties":{"ot":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q1":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q2":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q3":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"q4":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]}},"title":"SportsBasketballScoreTable","type":"object"},"Response762Cca4421D2_SportsBasketballStanding":{"properties":{"games_behind":{"title":"Games Behind","type":"number"},"matches_lost":{"title":"Matches Lost","type":"integer"},"matches_lost_pros":{"title":"Matches Lost Pros","type":"string"},"matches_played":{"title":"Matches Played","type":"integer"},"matches_won":{"title":"Matches Won","type":"integer"},"matches_won_pros":{"title":"Matches Won Pros","type":"string"},"rank":{"title":"Rank","type":"integer"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["team","rank","matches_played","matches_won","matches_won_pros","matches_lost","matches_lost_pros","games_behind"],"title":"SportsBasketballStanding","type":"object"},"Response762Cca4421D2_SportsBasketballStandingsGroup":{"properties":{"group_name":{"title":"Group Name","type":"string"},"stage":{"title":"Stage","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballStanding"},"title":"Standings","type":"array"}},"required":["group_name","standings","stage"],"title":"SportsBasketballStandingsGroup","type":"object"},"Response762Cca4421D2_SportsCompetition":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Id"},"name":{"title":"Name","type":"string"},"season":{"title":"Season","type":"string"}},"required":["id","name","season"],"title":"SportsCompetition","type":"object"},"Response762Cca4421D2_SportsCricketContentFixture":{"properties":{"details":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetails"},"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"lineups":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureLineup"},"title":"Lineups","type":"array"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketFixtureScore"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketFixtureStatus"},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"type":{"const":"fixture","default":"fixture","enum":["fixture"],"title":"Type","type":"string"},"upcoming":{"title":"Upcoming","type":"boolean"},"venue_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Venue Name"}},"required":["league","id","start_time","teams","status","upcoming","details","lineups"],"title":"SportsCricketContentFixture","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetails":{"properties":{"awayBattingBonus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Awaybattingbonus"},"awayBowlingBonus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Awaybowlingbonus"},"dl":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dl"},"homeBattingBonus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Homebattingbonus"},"homeBowlingBonus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Homebowlingbonus"},"innings":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInning"},"title":"Innings","type":"array"},"matchDay":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Matchday"},"minOversRemaining":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Minoversremaining"},"night":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Night"},"numberDays":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Numberdays"},"playerOfTheMatch1Id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playerofthematch1Id"},"playerOfTheMatch1Name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playerofthematch1Name"},"playerOfTheMatch2Id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playerofthematch2Id"},"playerOfTheMatch2Name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playerofthematch2Name"},"playerOfTheSeries1Id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playeroftheseries1Id"},"playerOfTheSeries1Name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playeroftheseries1Name"},"playerOfTheSeries2Id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playeroftheseries2Id"},"playerOfTheSeries2Name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playeroftheseries2Name"},"result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result"},"statusId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Statusid"},"toss":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Toss"},"tossDecision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tossdecision"},"tossWinnerTeamId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tosswinnerteamid"},"totalOvers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Totalovers"},"winMargin":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Winmargin"},"winTypeId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wintypeid"},"winnerId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Winnerid"}},"title":"SportsCricketContentFixtureDetails","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInning":{"properties":{"batters":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBatters"},{"type":"null"}]},"battingTeamId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Battingteamid"},"bestBatters":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBatter"},"title":"Bestbatters","type":"array"},"bestBowlers":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBowler"},"title":"Bestbowlers","type":"array"},"bowlers":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBowlers"},{"type":"null"}]},"bowlingTeamId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bowlingteamid"},"declared":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Declared"},"dlOvers":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Dlovers"},"dlTarget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dltarget"},"extras":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningExtras"},{"type":"null"}]},"fallOfWickets":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningFallOfWickets"},{"type":"null"}]},"followOn":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Followon"},"forfeited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forfeited"},"id":{"title":"Id","type":"integer"},"overnightRuns":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Overnightruns"},"overnightWickets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Overnightwickets"},"team":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningTeam"},{"type":"null"}]},"total":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningTotal"},{"type":"null"}]}},"required":["id"],"title":"SportsCricketContentFixtureDetailsInning","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBatter":{"properties":{"ballsFaced":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ballsfaced"},"bowledById":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bowledbyid"},"caughtById":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caughtbyid"},"day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Day"},"dismissalId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dismissalid"},"foursScored":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Foursscored"},"howOut":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Howout"},"id":{"title":"Id","type":"string"},"minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minutes"},"nonStrike":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Nonstrike"},"onStrike":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Onstrike"},"order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Order"},"runsScored":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Runsscored"},"sixesScored":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sixesscored"}},"required":["id"],"title":"SportsCricketContentFixtureDetailsInningBatter","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBatters":{"properties":{"batter":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBatter"},"title":"Batter","type":"array"}},"title":"SportsCricketContentFixtureDetailsInningBatters","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBowler":{"properties":{"ballsBowled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ballsbowled"},"dotBalls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dotballs"},"id":{"title":"Id","type":"string"},"maidensBowled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maidensbowled"},"noBalls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Noballs"},"nonStrike":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Nonstrike"},"onStrike":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Onstrike"},"order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Order"},"oversBowled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Oversbowled"},"runsConceded":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Runsconceded"},"totalBallsBowled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Totalballsbowled"},"wicketsTaken":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wicketstaken"},"wides":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wides"}},"required":["id"],"title":"SportsCricketContentFixtureDetailsInningBowler","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBowlers":{"properties":{"bowler":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningBowler"},"title":"Bowler","type":"array"}},"title":"SportsCricketContentFixtureDetailsInningBowlers","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningExtras":{"properties":{"byes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Byes"},"legByes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Legbyes"},"noBalls":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Noballs"},"penalties":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Penalties"},"totalExtras":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Totalextras"},"wides":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wides"}},"title":"SportsCricketContentFixtureDetailsInningExtras","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningFallOfWicket":{"properties":{"order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Order"},"overBall":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overball"},"playerId":{"title":"Playerid","type":"string"},"runs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Runs"},"totalBallsBowled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Totalballsbowled"}},"required":["playerId"],"title":"SportsCricketContentFixtureDetailsInningFallOfWicket","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningFallOfWickets":{"properties":{"fallOfWicket":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureDetailsInningFallOfWicket"},"title":"Fallofwicket","type":"array"}},"title":"SportsCricketContentFixtureDetailsInningFallOfWickets","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningTeam":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"title":"Id"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"logo":{"title":"Logo","type":"string"},"name":{"title":"Name","type":"string"},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"},"overs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overs"},"runs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Runs"},"score":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Score"}},"required":["name","logo"],"title":"SportsCricketContentFixtureDetailsInningTeam","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureDetailsInningTotal":{"properties":{"overs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overs"},"runsScored":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Runsscored"},"wickets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wickets"}},"title":"SportsCricketContentFixtureDetailsInningTotal","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureLineup":{"properties":{"name":{"title":"Name","type":"string"},"player":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixtureLineupPlayer"},"title":"Player","type":"array"}},"required":["name"],"title":"SportsCricketContentFixtureLineup","type":"object"},"Response762Cca4421D2_SportsCricketContentFixtureLineupPlayer":{"properties":{"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"gameRole":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gamerole"},"id":{"title":"Id","type":"string"},"initials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initials"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"},"matchName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matchname"},"middleName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Middlename"},"order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Order"},"teamRole":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Teamrole"}},"required":["id"],"title":"SportsCricketContentFixtureLineupPlayer","type":"object"},"Response762Cca4421D2_SportsCricketContentLeagueGames":{"properties":{"date":{"title":"Date","type":"string"},"date_kind":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDateKind"},"game_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Game Time"},"game_times":{"items":{"type":"integer"},"title":"Game Times","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureCricket"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_games","default":"league_games","enum":["league_games"],"title":"Type","type":"string"}},"required":["league","game_times","date","date_kind","games"],"title":"SportsCricketContentLeagueGames","type":"object"},"Response762Cca4421D2_SportsCricketContentLeagueStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_standings","default":"league_standings","enum":["league_standings"],"title":"Type","type":"string"}},"required":["league","group_standings"],"title":"SportsCricketContentLeagueStandings","type":"object"},"Response762Cca4421D2_SportsCricketContentTeamGames":{"properties":{"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureCricket"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_games","default":"team_games","enum":["team_games"],"title":"Type","type":"string"}},"required":["league","team","games"],"title":"SportsCricketContentTeamGames","type":"object"},"Response762Cca4421D2_SportsCricketContentTeamStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_standings","default":"team_standings","enum":["team_standings"],"title":"Type","type":"string"}},"required":["league","team","group_standings"],"title":"SportsCricketContentTeamStandings","type":"object"},"Response762Cca4421D2_SportsCricketFixtureScore":{"properties":{"away":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Away"},"away_overs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Away Overs"},"away_runs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Away Runs"},"home":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Home"},"home_overs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Home Overs"},"home_runs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Home Runs"}},"required":["home","away"],"title":"SportsCricketFixtureScore","type":"object"},"Response762Cca4421D2_SportsCricketFixtureStatus":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketFixtureStatusCode"},{"type":"null"}]}},"title":"SportsCricketFixtureStatus","type":"object"},"Response762Cca4421D2_SportsCricketFixtureStatusCode":{"enum":["ABN","BRK","FT","LIVE","NS","PST","SDL","SPR","STM","TRB"],"title":"SportsCricketFixtureStatusCode","type":"string"},"Response762Cca4421D2_SportsCricketStanding":{"properties":{"matches_drawn":{"title":"Matches Drawn","type":"string"},"matches_lost":{"title":"Matches Lost","type":"integer"},"matches_no_result":{"title":"Matches No Result","type":"string"},"matches_played":{"title":"Matches Played","type":"integer"},"matches_won":{"title":"Matches Won","type":"integer"},"net_run_rate":{"title":"Net Run Rate","type":"number"},"points":{"title":"Points","type":"string"},"rank":{"title":"Rank","type":"integer"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["team","rank","matches_played","matches_won","matches_drawn","matches_lost","matches_no_result","points","net_run_rate"],"title":"SportsCricketStanding","type":"object"},"Response762Cca4421D2_SportsCricketStandingsGroup":{"properties":{"group_name":{"title":"Group Name","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketStanding"},"title":"Standings","type":"array"}},"required":["group_name","standings"],"title":"SportsCricketStandingsGroup","type":"object"},"Response762Cca4421D2_SportsDataType":{"enum":["league","team","fixture"],"title":"SportsDataType","type":"string"},"Response762Cca4421D2_SportsDateKind":{"enum":["today","season_end","season_start","explicit"],"title":"SportsDateKind","type":"string"},"Response762Cca4421D2_SportsFixtureAggregateScore":{"properties":{"scores":{"additionalProperties":{"type":"integer"},"title":"Scores","type":"object"}},"required":["scores"],"title":"SportsFixtureAggregateScore","type":"object"},"Response762Cca4421D2_SportsFixtureAmericanFootball":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"phase":{"title":"Phase","type":"string"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"score_table":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballScoreTable"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballFixtureStatus"},{"type":"null"}]},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureVideo"},{"type":"null"}]}},"required":["id","teams","start_time","phase"],"title":"SportsFixtureAmericanFootball","type":"object"},"Response762Cca4421D2_SportsFixtureBaseball":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"score_table":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballScoreTable"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballFixtureStatus"},{"type":"null"}]},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureVideo"},{"type":"null"}]}},"required":["id","teams","start_time"],"title":"SportsFixtureBaseball","type":"object"},"Response762Cca4421D2_SportsFixtureBasketball":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"score_table":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballScoreTable"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballFixtureStatus"},{"type":"null"}]},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureVideo"},{"type":"null"}]}},"required":["id","teams","start_time"],"title":"SportsFixtureBasketball","type":"object"},"Response762Cca4421D2_SportsFixtureCricket":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketFixtureScore"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketFixtureStatus"},{"type":"null"}]},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureVideo"},{"type":"null"}]}},"required":["id","teams","start_time"],"title":"SportsFixtureCricket","type":"object"},"Response762Cca4421D2_SportsFixtureFootball":{"properties":{"aggregate_score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureAggregateScore"},{"type":"null"}]},"competition_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Competition Id"},"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballFixtureEvent"},"type":"array"},{"type":"null"}],"title":"Events"},"group":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLabel"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"ps_score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"round":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Round"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballFixtureStatus"},{"type":"null"}]},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureVideo"},{"type":"null"}]}},"required":["id","teams","start_time"],"title":"SportsFixtureFootball","type":"object"},"Response762Cca4421D2_SportsFixtureIceHockey":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"league_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"League Id"},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"score_table":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyScoreTable"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"status":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyFixtureStatus"},{"type":"null"}]},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureVideo"},{"type":"null"}]}},"required":["id","teams","start_time"],"title":"SportsFixtureIceHockey","type":"object"},"Response762Cca4421D2_SportsFixtureScore":{"properties":{"away":{"title":"Away","type":"integer"},"home":{"title":"Home","type":"integer"}},"required":["home","away"],"title":"SportsFixtureScore","type":"object"},"Response762Cca4421D2_SportsFixtureTeams":{"properties":{"away":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"home":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["home","away"],"title":"SportsFixtureTeams","type":"object"},"Response762Cca4421D2_SportsFixtureVideo":{"properties":{"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration"},"thumbnail":{"title":"Thumbnail","type":"string"},"type":{"default":"video","enum":["video","story"],"title":"Type","type":"string"},"url":{"title":"Url","type":"string"}},"required":["url","thumbnail"],"title":"SportsFixtureVideo","type":"object"},"Response762Cca4421D2_SportsFootballCoach":{"properties":{"name":{"title":"Name","type":"string"},"photo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photo"}},"required":["name"],"title":"SportsFootballCoach","type":"object"},"Response762Cca4421D2_SportsFootballContentFixture":{"properties":{"aggregate_score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureAggregateScore"},{"type":"null"}]},"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballFixtureEvent"},"type":"array"},{"type":"null"}],"title":"Events"},"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"title":"Id"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"lineups":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballLineups"},{"type":"null"}]},"ps_score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"score":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"start_time":{"title":"Start Time","type":"integer"},"statistics":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsStatistic"},"type":"array"},{"type":"null"}],"title":"Statistics"},"status":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballFixtureStatus"},"teams":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureTeams"},"type":{"const":"fixture","default":"fixture","enum":["fixture"],"title":"Type","type":"string"}},"required":["league","id","start_time","teams","status"],"title":"SportsFootballContentFixture","type":"object"},"Response762Cca4421D2_SportsFootballContentLeagueGames":{"properties":{"date":{"title":"Date","type":"string"},"date_kind":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDateKind"},"game_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Game Time"},"game_times":{"items":{"type":"integer"},"title":"Game Times","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureFootball"},"title":"Games","type":"array"},"group_standings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballStandingsGroup"},"type":"array"},{"type":"null"}],"title":"Group Standings"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"structure":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Structure"},"type":{"const":"league_games","default":"league_games","enum":["league_games"],"title":"Type","type":"string"}},"required":["league","game_times","date","date_kind","games"],"title":"SportsFootballContentLeagueGames","type":"object"},"Response762Cca4421D2_SportsFootballContentLeagueStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_standings","default":"league_standings","enum":["league_standings"],"title":"Type","type":"string"}},"required":["league","group_standings"],"title":"SportsFootballContentLeagueStandings","type":"object"},"Response762Cca4421D2_SportsFootballContentTeamGames":{"properties":{"competitions":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCompetition"},"title":"Competitions","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureFootball"},"title":"Games","type":"array"},"group_standings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballStandingsGroup"},"type":"array"},{"type":"null"}],"title":"Group Standings"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_games","default":"team_games","enum":["team_games"],"title":"Type","type":"string"}},"required":["league","team","games","competitions"],"title":"SportsFootballContentTeamGames","type":"object"},"Response762Cca4421D2_SportsFootballContentTeamStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_standings","default":"team_standings","enum":["team_standings"],"title":"Type","type":"string"}},"required":["league","team","group_standings"],"title":"SportsFootballContentTeamStandings","type":"object"},"Response762Cca4421D2_SportsFootballFixtureEvent":{"properties":{"assist_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assist Name"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"elapsed":{"title":"Elapsed","type":"integer"},"extra":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Extra"},"player_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Player Name"},"team_id":{"title":"Team Id","type":"integer"},"type":{"title":"Type","type":"string"}},"required":["team_id","type","elapsed"],"title":"SportsFootballFixtureEvent","type":"object"},"Response762Cca4421D2_SportsFootballFixtureStatus":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballFixtureStatusCode"},{"type":"null"}]},"elapsed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Elapsed"},"extra":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Extra"}},"title":"SportsFootballFixtureStatus","type":"object"},"Response762Cca4421D2_SportsFootballFixtureStatusCode":{"enum":["AET","BT","CANC","ET","FT","1H","2H","HT","LIVE","NS","P","PEN","PST","SUSP","TBD"],"title":"SportsFootballFixtureStatusCode","type":"string"},"Response762Cca4421D2_SportsFootballLineup":{"properties":{"coach":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballCoach"},"formation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formation"},"startXI":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballPlayer"},"title":"Startxi","type":"array"},"substitutes":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballPlayer"},"title":"Substitutes","type":"array"}},"required":["startXI","substitutes","coach"],"title":"SportsFootballLineup","type":"object"},"Response762Cca4421D2_SportsFootballLineups":{"properties":{"away":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballLineup"},"home":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballLineup"}},"required":["home","away"],"title":"SportsFootballLineups","type":"object"},"Response762Cca4421D2_SportsFootballPlayer":{"properties":{"grid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grid"},"name":{"title":"Name","type":"string"},"number":{"title":"Number","type":"integer"},"photo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photo"},"pos":{"title":"Pos","type":"string"}},"required":["name","number","pos"],"title":"SportsFootballPlayer","type":"object"},"Response762Cca4421D2_SportsFootballStanding":{"properties":{"form":{"title":"Form","type":"string"},"goals_against":{"title":"Goals Against","type":"integer"},"goals_for":{"title":"Goals For","type":"integer"},"label":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLabel"},{"type":"null"}]},"matches_drawn":{"title":"Matches Drawn","type":"integer"},"matches_lost":{"title":"Matches Lost","type":"integer"},"matches_played":{"title":"Matches Played","type":"integer"},"matches_won":{"title":"Matches Won","type":"integer"},"points":{"title":"Points","type":"integer"},"rank":{"title":"Rank","type":"integer"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["team","rank","matches_played","matches_won","matches_drawn","matches_lost","goals_for","goals_against","points","form"],"title":"SportsFootballStanding","type":"object"},"Response762Cca4421D2_SportsFootballStandingsGroup":{"properties":{"group_name":{"title":"Group Name","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballStanding"},"title":"Standings","type":"array"}},"required":["group_name","standings"],"title":"SportsFootballStandingsGroup","type":"object"},"Response762Cca4421D2_SportsIceHockeyContentLeagueGames":{"properties":{"date":{"title":"Date","type":"string"},"date_kind":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDateKind"},"game_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Game Time"},"game_times":{"items":{"type":"integer"},"title":"Game Times","type":"array"},"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureIceHockey"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_games","default":"league_games","enum":["league_games"],"title":"Type","type":"string"}},"required":["league","game_times","date","date_kind","games"],"title":"SportsIceHockeyContentLeagueGames","type":"object"},"Response762Cca4421D2_SportsIceHockeyContentLeagueStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"type":{"const":"league_standings","default":"league_standings","enum":["league_standings"],"title":"Type","type":"string"}},"required":["league","group_standings"],"title":"SportsIceHockeyContentLeagueStandings","type":"object"},"Response762Cca4421D2_SportsIceHockeyContentTeamGames":{"properties":{"games":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureIceHockey"},"title":"Games","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_games","default":"team_games","enum":["team_games"],"title":"Type","type":"string"}},"required":["league","team","games"],"title":"SportsIceHockeyContentTeamGames","type":"object"},"Response762Cca4421D2_SportsIceHockeyContentTeamStandings":{"properties":{"group_standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyStandingsGroup"},"title":"Group Standings","type":"array"},"league":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLeague"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"},"type":{"const":"team_standings","default":"team_standings","enum":["team_standings"],"title":"Type","type":"string"}},"required":["league","team","group_standings"],"title":"SportsIceHockeyContentTeamStandings","type":"object"},"Response762Cca4421D2_SportsIceHockeyFixtureStatus":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyFixtureStatusCode"},{"type":"null"}]},"elapsed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Elapsed"}},"title":"SportsIceHockeyFixtureStatus","type":"object"},"Response762Cca4421D2_SportsIceHockeyFixtureStatusCode":{"enum":["NS","P1","P2","P3","OT","PT","BT","AW","POST","CANC","INTR","ABD","AOT","AP","FT"],"title":"SportsIceHockeyFixtureStatusCode","type":"string"},"Response762Cca4421D2_SportsIceHockeyScoreTable":{"properties":{"ot":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"p1":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"p2":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"p3":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]},"so":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFixtureScore"},{"type":"null"}]}},"title":"SportsIceHockeyScoreTable","type":"object"},"Response762Cca4421D2_SportsIceHockeyStanding":{"properties":{"form":{"title":"Form","type":"string"},"matches_lost":{"title":"Matches Lost","type":"integer"},"matches_lost_pros":{"title":"Matches Lost Pros","type":"string"},"matches_played":{"title":"Matches Played","type":"integer"},"matches_won":{"title":"Matches Won","type":"integer"},"matches_won_pros":{"title":"Matches Won Pros","type":"string"},"points":{"title":"Points","type":"integer"},"rank":{"title":"Rank","type":"integer"},"team":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsTeam"}},"required":["team","rank","matches_played","matches_won","matches_won_pros","matches_lost","matches_lost_pros","points","form"],"title":"SportsIceHockeyStanding","type":"object"},"Response762Cca4421D2_SportsIceHockeyStandingsGroup":{"properties":{"group_name":{"title":"Group Name","type":"string"},"stage":{"title":"Stage","type":"string"},"standings":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyStanding"},"title":"Standings","type":"array"}},"required":["group_name","standings","stage"],"title":"SportsIceHockeyStandingsGroup","type":"object"},"Response762Cca4421D2_SportsLabel":{"properties":{"i18n":{"title":"I18N","type":"string"},"i18n_opts":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"I18N Opts"},"kind":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsLabelKind"},{"type":"null"}]}},"required":["i18n"],"title":"SportsLabel","type":"object"},"Response762Cca4421D2_SportsLabelKind":{"enum":["qualification","relegation","unknown"],"title":"SportsLabelKind","type":"string"},"Response762Cca4421D2_SportsLeague":{"properties":{"has_standings":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Standings"},"id":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Id"},"logo":{"title":"Logo","type":"string"},"name":{"title":"Name","type":"string"},"round":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Round"},"season":{"title":"Season","type":"string"}},"required":["id","name","logo","season"],"title":"SportsLeague","type":"object"},"Response762Cca4421D2_SportsResultAmericanFootball":{"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballContentLeagueGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballContentLeagueStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballContentTeamGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballContentTeamStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsAmericanFootballContentFixture"}],"title":"Content"},"sport":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsType","default":"american_football"},"type":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDataType"},"view":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsView"}},"required":["type","view","content"],"title":"SportsResultAmericanFootball","type":"object"},"Response762Cca4421D2_SportsResultBaseball":{"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballContentLeagueGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballContentLeagueStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballContentTeamGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBaseballContentTeamStandings"}],"title":"Content"},"sport":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsType","default":"baseball"},"type":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDataType"},"view":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsView"}},"required":["type","view","content"],"title":"SportsResultBaseball","type":"object"},"Response762Cca4421D2_SportsResultBasketball":{"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballContentLeagueGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballContentLeagueStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballContentTeamGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsBasketballContentTeamStandings"}],"title":"Content"},"sport":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsType","default":"basketball"},"type":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDataType"},"view":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsView"}},"required":["type","view","content"],"title":"SportsResultBasketball","type":"object"},"Response762Cca4421D2_SportsResultCricket":{"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentLeagueGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentLeagueStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentTeamGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentTeamStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsCricketContentFixture"}],"title":"Content"},"sport":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsType","default":"cricket"},"type":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDataType"},"view":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsView"}},"required":["type","view","content"],"title":"SportsResultCricket","type":"object"},"Response762Cca4421D2_SportsResultFootball":{"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballContentFixture"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballContentLeagueGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballContentTeamStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballContentLeagueStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsFootballContentTeamGames"}],"title":"Content"},"sport":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsType","default":"football"},"type":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDataType"},"view":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsView"}},"required":["type","view","content"],"title":"SportsResultFootball","type":"object"},"Response762Cca4421D2_SportsResultIceHockey":{"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyContentLeagueGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyContentLeagueStandings"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyContentTeamGames"},{"$ref":"#/components/schemas/Response762Cca4421D2_SportsIceHockeyContentTeamStandings"}],"title":"Content"},"sport":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsType","default":"ice_hockey"},"type":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsDataType"},"view":{"$ref":"#/components/schemas/Response762Cca4421D2_SportsView"}},"required":["type","view","content"],"title":"SportsResultIceHockey","type":"object"},"Response762Cca4421D2_SportsStatistic":{"properties":{"away":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"title":"Away"},"home":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"title":"Home"},"name":{"title":"Name","type":"string"}},"required":["name"],"title":"SportsStatistic","type":"object"},"Response762Cca4421D2_SportsTeam":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"title":"Id"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"logo":{"title":"Logo","type":"string"},"name":{"title":"Name","type":"string"},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"}},"required":["name","logo"],"title":"SportsTeam","type":"object"},"Response762Cca4421D2_SportsType":{"enum":["basketball","baseball","football","american_football","formula_1","ice_hockey","rugby","tennis","golf","cricket"],"title":"SportsType","type":"string"},"Response762Cca4421D2_SportsView":{"enum":["games","standings","fixture","bracket"],"title":"SportsView","type":"string"},"Response762Cca4421D2_StockObservation":{"properties":{"average":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average"},"close":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Close"},"date":{"title":"Date","type":"string"},"high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High"},"label":{"title":"Label","type":"string"},"low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low"},"minute":{"title":"Minute","type":"string"},"previous_close":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous Close"},"timestamp":{"title":"Timestamp","type":"integer"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume"}},"required":["date","minute","label","timestamp"],"title":"StockObservation","type":"object"},"Response762Cca4421D2_StockResult":{"properties":{"asset_info":{"$ref":"#/components/schemas/Response762Cca4421D2_AssetInfo"},"exchange_info":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_ExchangeInfo"},{"type":"null"}]},"quote":{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__rich_header__results__stocks__v1__Quote"},"time_range":{"$ref":"#/components/schemas/Response762Cca4421D2_TickerPlotTimeRange"},"timeseries":{"$ref":"#/components/schemas/Response762Cca4421D2_StockResultTimeseries"}},"required":["asset_info","time_range","quote","timeseries"],"title":"StockResult","type":"object"},"Response762Cca4421D2_StockResultTimeseries":{"properties":{"time_range":{"$ref":"#/components/schemas/Response762Cca4421D2_TickerPlotTimeRange"},"timeseries":{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_StockObservation"},"title":"Timeseries","type":"array"}},"required":["time_range","timeseries"],"title":"StockResultTimeseries","type":"object"},"Response762Cca4421D2_SuggestResult":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The suggested query enriched description.","title":"Description"},"img":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The suggested query enriched image URL.","title":"Img"},"is_entity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the suggested enriched query is an entity. Deprecated: use type instead.","title":"Is Entity"},"query":{"description":"Suggested query completion.","title":"Query","type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The suggested query enriched title.","title":"Title"},"type":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SuggestType"},{"type":"null"}],"description":"Kind of suggestion, currently query or entity. New kinds may be added, so treat an unrecognised value as a plain query suggestion."}},"required":["query"],"title":"SuggestResult","type":"object"},"Response762Cca4421D2_SuggestSearchApiResponse":{"properties":{"query":{"$ref":"#/components/schemas/Response762Cca4421D2_OriginalQuery","description":"Suggest search query string. Only the original query is returned."},"results":{"default":[],"description":"The list of suggestions for the given query.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_SuggestResult"},"title":"Results","type":"array"},"type":{"const":"suggest","default":"suggest","enum":["suggest"],"title":"Type","type":"string"}},"required":["query"],"title":"SuggestSearchApiResponse","type":"object"},"Response762Cca4421D2_SuggestType":{"description":"summarizer.","enum":["summarizer"],"title":"Type","type":"string"}},"required":["key"],"title":"Summarizer","type":"object"},"Response762Cca4421D2_TemperatureDailyFeelsLikeSummary":{"properties":{"day":{"title":"Day","type":"number"},"evening":{"title":"Evening","type":"number"},"morning":{"title":"Morning","type":"number"},"night":{"title":"Night","type":"number"}},"required":["day","night","evening","morning"],"title":"TemperatureDailyFeelsLikeSummary","type":"object"},"Response762Cca4421D2_TemperatureDailySummary":{"properties":{"day":{"title":"Day","type":"number"},"evening":{"title":"Evening","type":"number"},"max":{"title":"Max","type":"number"},"min":{"title":"Min","type":"number"},"morning":{"title":"Morning","type":"number"},"night":{"title":"Night","type":"number"}},"required":["day","min","max","night","evening","morning"],"title":"TemperatureDailySummary","type":"object"},"Response762Cca4421D2_TemperatureSummary3Hours":{"properties":{"feels_like":{"title":"Feels Like","type":"number"},"max":{"title":"Max","type":"number"},"min":{"title":"Min","type":"number"},"temp":{"title":"Temp","type":"number"}},"required":["temp","feels_like","min","max"],"title":"TemperatureSummary3Hours","type":"object"},"Response762Cca4421D2_TickerPlotTimeRange":{"enum":["1d","5d","7d","1m","3m","6m","ytd","1y","2y","5y","max"],"title":"TickerPlotTimeRange","type":"string"},"Response762Cca4421D2_Timeseries":{"properties":{"time_range":{"$ref":"#/components/schemas/Response762Cca4421D2_TickerPlotTimeRange"},"ts_exchange_rate":{"default":[],"items":{"maxItems":2,"minItems":2,"prefixItems":[{"type":"string"},{"type":"number"}],"type":"array"},"title":"Ts Exchange Rate","type":"array"}},"required":["time_range"],"title":"Timeseries","type":"object"},"Response762Cca4421D2_TopStoriesNewsResult":{"properties":{"articles":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_TopStoryNewsArticle"},"title":"Articles","type":"array"},"is_topical":{"title":"Is Topical","type":"boolean"},"topic_id":{"title":"Topic Id","type":"integer"},"topics":{"default":[],"items":{"$ref":"#/components/schemas/Response762Cca4421D2_Topic"},"title":"Topics","type":"array"}},"required":["is_topical","topic_id"],"title":"TopStoriesNewsResult","type":"object"},"Response762Cca4421D2_TopStoryNewsArticle":{"properties":{"bo_debug":{"default":{},"title":"Bo Debug","type":"object"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"extra_snippets":{"default":[],"items":{"type":"string"},"title":"Extra Snippets","type":"array"},"img":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img"},"img_small":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Small"},"is_live":{"default":false,"title":"Is Live","type":"boolean"},"meta_url":{"$ref":"#/components/schemas/Response762Cca4421D2_snakepit__models__mixer__specs__atomic__MetaUrl"},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Age"},"publish_time":{"title":"Publish Time","type":"integer"},"publisher_name":{"title":"Publisher Name","type":"string"},"title":{"title":"Title","type":"string"},"url":{"title":"Url","type":"string"}},"required":["title","url","meta_url","publisher_name","publish_time"],"title":"TopStoryNewsArticle","type":"object"},"Response762Cca4421D2_Topic":{"properties":{"index":{"title":"Index","type":"integer"},"query":{"title":"Query","type":"string"},"score":{"title":"Score","type":"number"},"title":{"title":"Title","type":"string"}},"required":["index","title","score","query"],"title":"Topic","type":"object"},"Response762Cca4421D2_TrackingNumber":{"properties":{"courier":{"$ref":"#/components/schemas/Response762Cca4421D2_Courier"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tracking_number":{"title":"Tracking Number","type":"string"},"tracking_url":{"title":"Tracking Url","type":"string"}},"required":["tracking_number","tracking_url","courier"],"title":"TrackingNumber","type":"object"},"Response762Cca4421D2_TripadvisorReview":{"description":"A model representing a Tripadvisor review.","properties":{"author":{"$ref":"#/components/schemas/Response762Cca4421D2_Person","description":"The author of the review."},"date":{"description":"The date when the review was published.","title":"Date","type":"string"},"description":{"description":"A description seen in the review.","title":"Description","type":"string"},"language":{"description":"The language of the review.","title":"Language","type":"string"},"rating":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating","description":"A rating given by the reviewer."},"review_url":{"description":"A URL link to the page where the review can be found.","title":"Review Url","type":"string"},"title":{"description":"The title of the review.","title":"Title","type":"string"}},"required":["title","description","date","rating","author","review_url","language"],"title":"TripadvisorReview","type":"object"},"Response762Cca4421D2_TsToDate":{"properties":{"input_ts":{"title":"Input Ts","type":"integer"},"intent_type":{"const":"ts_to_date","default":"ts_to_date","enum":["ts_to_date"],"title":"Intent Type","type":"string"}},"required":["input_ts"],"title":"TsToDate","type":"object"},"Response762Cca4421D2_Unit":{"description":"A model representing a unit of measurement.","properties":{"units":{"description":"The name of the unit associated with the quantity.","title":"Units","type":"string"},"value":{"description":"The quantity of the unit.","title":"Value","type":"number"}},"required":["value","units"],"title":"Unit","type":"object"},"Response762Cca4421D2_UnitConversionDimensionality":{"enum":["angle","area","data_transfer","digital","duration","energy","force","frequency","length","mass","power","pressure","speed","temperature","volume"],"title":"UnitConversionDimensionality","type":"string"},"Response762Cca4421D2_UnitConversionResult":{"properties":{"amount":{"title":"Amount","type":"number"},"dimensionality":{"$ref":"#/components/schemas/Response762Cca4421D2_UnitConversionDimensionality"},"from_unit":{"title":"From Unit","type":"string"},"to_unit":{"title":"To Unit","type":"string"}},"required":["amount","from_unit","to_unit","dimensionality"],"title":"UnitConversionResult","type":"object"},"Response762Cca4421D2_UnixTimestampResult":{"properties":{"conversion":{"discriminator":{"mapping":{"date_to_ts":"#/components/schemas/Response762Cca4421D2_DateToTs","now_to_date":"#/components/schemas/Response762Cca4421D2_NowToDate","now_to_ts":"#/components/schemas/Response762Cca4421D2_NowToTs","ts_to_date":"#/components/schemas/Response762Cca4421D2_TsToDate"},"propertyName":"intent_type"},"oneOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_TsToDate"},{"$ref":"#/components/schemas/Response762Cca4421D2_DateToTs"},{"$ref":"#/components/schemas/Response762Cca4421D2_NowToTs"},{"$ref":"#/components/schemas/Response762Cca4421D2_NowToDate"}],"title":"Conversion"}},"required":["conversion"],"title":"UnixTimestampResult","type":"object"},"Response762Cca4421D2_VideoSearchApiResponse":{"properties":{"extra":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Extra","description":"Additional information about the video search results."},"query":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Query","description":"Video search query string."},"results":{"default":[],"description":"The list of video results for the given query.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__VideoResult"},"title":"Results","type":"array"},"type":{"const":"videos","default":"videos","enum":["videos"],"title":"Type","type":"string"}},"required":["query","extra"],"title":"VideoSearchApiResponse","type":"object"},"Response762Cca4421D2_Videos":{"properties":{"mutated_by_goggles":{"default":false,"description":"Whether the results are mutated by a goggle.","title":"Mutated By Goggles","type":"boolean"},"results":{"description":"The list of video results.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__VideoResult"},"title":"Results","type":"array"},"type":{"const":"videos","default":"videos","description":"The type of API result. The value is always videos.","enum":["videos"],"title":"Type","type":"string"}},"required":["results"],"title":"Videos","type":"object"},"Response762Cca4421D2_VsCurrency":{"description":"faq.","enum":["faq"],"title":"Type","type":"string"}},"required":["results"],"title":"FAQ","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__images__Extra":{"properties":{"might_be_offensive":{"default":false,"description":"Indicates whether the image search results might contain offensive content.","title":"Might Be Offensive","type":"boolean"}},"title":"Extra","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__images__MetaUrl":{"properties":{"favicon":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The favicon used for the URL.","title":"Favicon"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The lowercased domain name extracted from the URL.","title":"Hostname"},"netloc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The network location part extracted from the URL.","title":"Netloc"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The hierarchical path of the URL useful as a display string.","title":"Path"},"scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The protocol scheme extracted from the URL.","title":"Scheme"}},"title":"MetaUrl","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__images__Query":{"properties":{"altered":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The altered query by the spellchecker. This is the query that is used to search.","title":"Altered"},"original":{"description":"The original query that was requested.","title":"Original","type":"string"},"show_strict_warning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"The value is true if the lack of results is due to a strict safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch.","title":"Show Strict Warning"},"spellcheck_off":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the spellchecker is enabled or disabled.","title":"Spellcheck Off"}},"required":["original"],"title":"Query","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__images__Thumbnail":{"properties":{"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the image.","title":"Height"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The served URL of the image.","title":"Src"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the image.","title":"Width"}},"title":"Thumbnail","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__language__Language":{"description":"A model representing a language.","properties":{"main":{"description":"The main language seen in the string.","title":"Main","type":"string"}},"required":["main"],"title":"Language","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__news__MetaUrl":{"properties":{"favicon":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The favicon used for the URL.","title":"Favicon"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The lowercased domain name extracted from the URL.","title":"Hostname"},"netloc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The network location part extracted from the URL.","title":"Netloc"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The hierarchical path of the URL useful as a display string.","title":"Path"},"scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The protocol scheme extracted from the URL.","title":"Scheme"}},"title":"MetaUrl","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__news__NewsResult":{"properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A human-readable representation of the news article’s age. For example, 2 days ago.","title":"Age"},"breaking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the result includes breaking news.","title":"Breaking"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The description for the news article.","title":"Description"},"extra_snippets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of extra alternate snippets for the news search result.","title":"Extra Snippets"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"icons":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_PostprocessedIcon"},"type":"array"},{"type":"null"}],"description":"Icons associated with the news result.","title":"Icons"},"meta_url":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__news__MetaUrl"},{"type":"null"}],"description":"Aggregated information on the URL associated with the news search result."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ.","title":"Page Fetched"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__news__Thumbnail"},{"type":"null"}],"description":"The thumbnail for the news article."},"title":{"description":"The title of the news article.","title":"Title","type":"string"},"type":{"const":"news_result","default":"news_result","description":"The type of news search API result. The value is always news_result.","enum":["news_result"],"title":"Type","type":"string"},"url":{"description":"The source URL of the news article.","title":"Url","type":"string"}},"required":["title","url"],"title":"NewsResult","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__news__Query":{"properties":{"altered":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The altered query by the spellchecker. This is the query that is used to search if any.","title":"Altered"},"cleaned":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The cleaned normalized query by the spellchecker. This is the query that is used to search if any.","title":"Cleaned"},"original":{"description":"The original query that was requested.","title":"Original","type":"string"},"search_operators":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SearchOperators"},{"type":"null"}],"description":"Search operators applied to the query."},"show_strict_warning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"The value is true if the lack of results is due to a strict safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch.","title":"Show Strict Warning"},"spellcheck_off":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the spellchecker is enabled or disabled.","title":"Spellcheck Off"}},"required":["original"],"title":"Query","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__news__Thumbnail":{"properties":{"original":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The original URL of the thumbnail associated with the news article.","title":"Original"},"src":{"description":"The served URL of the thumbnail associated with the news article.","title":"Src","type":"string"}},"required":["src"],"title":"Thumbnail","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__query__Query":{"properties":{"altered":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The altered query by the spellchecker.","title":"Altered"},"ask_for_location":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to prompt the user for their location.","title":"Ask For Location"},"bad_results":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the results are considered low quality.","title":"Bad Results"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The city for location-based queries.","title":"City"},"cleaned":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The cleaned normalized query.","title":"Cleaned"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The country code for the query.","title":"Country"},"custom_location_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A custom label for the location.","title":"Custom Location Label"},"header_country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The country from request headers.","title":"Header Country"},"is_geolocal":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the query has local intent.","title":"Is Geolocal"},"is_navigational":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the query is navigational (user wants to go to a specific site).","title":"Is Navigational"},"is_news_breaking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the query is related to breaking news.","title":"Is News Breaking"},"is_trending":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the query is a trending topic.","title":"Is Trending"},"language":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__language__Language"},{"type":"null"}],"description":"The detected language of the query."},"lat":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The latitude for location-based queries.","title":"Lat"},"local_decision":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The local search decision for the query.","title":"Local Decision"},"local_locations_idx":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Index of the local location result.","title":"Local Locations Idx"},"long":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The longitude for location-based queries.","title":"Long"},"more_results_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether more results are available for pagination.","title":"More Results Available"},"original":{"description":"The original query that was requested.","title":"Original","type":"string"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The postal code for location-based queries.","title":"Postal Code"},"reddit_cluster":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Reddit cluster identifier for discussion results.","title":"Reddit Cluster"},"related_queries":{"default":[],"description":"Related queries for the query.","items":{"type":"string"},"title":"Related Queries","type":"array"},"safesearch":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether safesearch is active.","title":"Safesearch"},"search_operators":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SearchOperators"},{"type":"null"}],"description":"Search operators that were detected and applied to the query."},"should_fallback":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to fallback to alternative ranking.","title":"Should Fallback"},"show_strict_warning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to show a warning that strict safesearch filtered results.","title":"Show Strict Warning"},"spellcheck_off":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether spellcheck is disabled for this query.","title":"Spellcheck Off"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The state/region for location-based queries.","title":"State"},"summary_key":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Key to retrieve AI-generated summary for the query.","title":"Summary Key"}},"required":["original"],"title":"Query","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__DataProvider":{"description":"A model representing the data provider associated with the entity.","properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The served URL for the image data.","title":"Img"},"long_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The long name for the data provider.","title":"Long Name"},"name":{"description":"The name of the data provider. This can be a domain.","title":"Name","type":"string"},"type":{"const":"external","default":"external","description":"The type representing the source of data. This is usually external.","enum":["external"],"title":"Type","type":"string"},"url":{"description":"The URL where the information is coming from.","title":"Url","type":"string"}},"required":["name","url"],"title":"DataProvider","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__FAQ":{"description":"Frequently asked questions associated with a search result.","properties":{"items":{"description":"A list of question/answer pairs.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_QA"},"title":"Items","type":"array"}},"required":["items"],"title":"FAQ","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__MetaUrl":{"description":"Aggregated information about a URL.","properties":{"favicon":{"description":"The favicon used for the URL.","title":"Favicon","type":"string"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The lowercased domain name extracted from the URL.","title":"Hostname"},"netloc":{"description":"The network location part extracted from the URL.","title":"Netloc","type":"string"},"path":{"description":"The hierarchical path of the URL useful as a display string.","title":"Path","type":"string"},"scheme":{"description":"The protocol scheme extracted from the URL.","title":"Scheme","type":"string"}},"required":["scheme","netloc","favicon","path"],"title":"MetaUrl","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__NewsResult":{"description":"A model representing news results.","properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A human-readable representation of the news article’s age. For example, 2 days ago.","title":"Age"},"breaking":{"default":false,"description":"Whether the news result is currently a breaking news.","title":"Breaking","type":"boolean"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"extra_snippets":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of extra alternate snippets for the news search result.","title":"Extra Snippets"},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"icons":{"anyOf":[{"items":{"$ref":"#/components/schemas/Response762Cca4421D2_PostprocessedIcon"},"type":"array"},{"type":"null"}],"description":"Icons associated with the news result.","title":"Icons"},"is_live":{"default":false,"description":"Whether the news result is currently live.","title":"Is Live","type":"boolean"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"meta_url":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"The aggregated information on the URL representing a news result.","title":"Meta Url"},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The source of the news.","title":"Source"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail associated with the news result."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"}},"required":["title","url"],"title":"NewsResult","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__Offer":{"description":"An offer associated with a product.","properties":{"price":{"description":"The price of the product currently on offer.","title":"Price","type":"string"},"priceCurrency":{"description":"The currency in which the offer is made.","title":"Pricecurrency","type":"string"},"url":{"description":"The URL where the offer can be found.","title":"Url","type":"string"}},"required":["url","priceCurrency","price"],"title":"Offer","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__Product":{"description":"A model representing a product.","properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The category of the product.","title":"Category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The description of the product.","title":"Description"},"gtin":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A Global Trade Item Number (GTIN) for the product.","title":"Gtin"},"gtin12":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The GTIN-12 (UPC) code of the product.","title":"Gtin12"},"gtin13":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The GTIN-13 (EAN/ISBN-13) code of the product.","title":"Gtin13"},"gtin14":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The GTIN-14 code of the product.","title":"Gtin14"},"gtin8":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The GTIN-8 (EAN/UCC-8) code of the product.","title":"Gtin8"},"name":{"description":"The name of the product.","minLength":1,"title":"Name","type":"string"},"offers":{"default":[],"description":"A list of offers available on the product.","items":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Offer"},"title":"Offers","type":"array"},"price":{"description":"The price of the product.","title":"Price","type":"string"},"rating":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Rating"},{"type":"null"}],"description":"A rating associated with the product."},"thumbnail":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail","description":"A thumbnail associated with the product."},"type":{"const":"Product","default":"Product","description":"A string representing a product type. The value is always Product.","enum":["Product"],"title":"Type","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The URL of the product page.","title":"Url"}},"required":["name","price","thumbnail"],"title":"Product","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__Profile":{"description":"A profile of an entity.","properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The served image URL representing the profile.","title":"Img"},"long_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The long name of the profile.","title":"Long Name"},"name":{"description":"The name of the profile.","title":"Name","type":"string"},"url":{"description":"The original URL where the profile is available.","title":"Url","type":"string"}},"required":["name","url"],"title":"Profile","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__Rating":{"description":"The rating associated with an entity.","properties":{"bestRating":{"description":"Best rating received.","exclusiveMinimum":0,"title":"Bestrating","type":"number"},"is_tripadvisor":{"default":false,"description":"Whether the rating is coming from Tripadvisor.","title":"Is Tripadvisor","type":"boolean"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"The profile associated with the rating."},"ratingValue":{"description":"The current value of the rating.","minimum":0,"title":"Ratingvalue","type":"number"},"reviewCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of reviews associated with the rating.","title":"Reviewcount"}},"required":["ratingValue","bestRating"],"title":"Rating","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail":{"description":"Aggregated details representing a picture thumbnail.","properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The alt text for the thumbnail image.","title":"Alt"},"bg_color":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The background color of the thumbnail.","title":"Bg Color"},"duplicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the thumbnail is a duplicate.","title":"Duplicated"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the thumbnail.","title":"Height"},"logo":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the thumbnail is a logo.","title":"Logo"},"original":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The original URL of the image.","title":"Original"},"src":{"description":"The served URL of the picture thumbnail.","title":"Src","type":"string"},"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The theme of the thumbnail (e.g., light or dark).","title":"Theme"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the thumbnail.","title":"Width"}},"required":["src"],"title":"Thumbnail","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__VideoData":{"description":"A model representing metadata gathered for a video.","properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"Author of the video."},"creator":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The creator of the video.","title":"Creator"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A time string representing the duration of the video. The format can be HH:MM:SS or MM:SS.","title":"Duration"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The publisher of the video.","title":"Publisher"},"requires_subscription":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the video requires a subscription to watch.","title":"Requires Subscription"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of tags associated with the video.","title":"Tags"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"A thumbnail associated with the video."},"views":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The number of views of the video.","title":"Views"}},"title":"VideoData","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__shared__VideoResult":{"description":"A model representing a video result.","properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A human-readable representation of the video’s age. For example, 2 days ago.","title":"Age"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","description":"A description for the web page.","title":"Description"},"family_friendly":{"default":true,"description":"Whether the web page is family friendly.","title":"Family Friendly","type":"boolean"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"is_source_both":{"default":false,"description":"Whether the result is from both local and global sources.","title":"Is Source Both","type":"boolean"},"is_source_local":{"default":false,"description":"Whether the result is from a local source.","title":"Is Source Local","type":"boolean"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A language classification for the web page.","title":"Language"},"meta_url":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__MetaUrl"},{"type":"null"}],"description":"Aggregated information on the URL."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A date representing when the web page was last fetched.","title":"Page Fetched"},"profile":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Profile"},{"type":"null"}],"description":"A profile associated with the web page."},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The publisher of the video.","title":"Publisher"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__Thumbnail"},{"type":"null"}],"description":"The thumbnail of the video."},"title":{"description":"The title of the web page.","title":"Title","type":"string"},"type":{"const":"video_result","default":"video_result","description":"The type identifying the video result. The value is always video_result.","enum":["video_result"],"title":"Type","type":"string"},"url":{"description":"The URL where the page is served.","title":"Url","type":"string"},"video":{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__shared__VideoData","description":"Meta data for the video."}},"required":["title","url","video"],"title":"VideoResult","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__Extra":{"properties":{"might_be_offensive":{"default":false,"description":"Indicates whether the video search results might contain offensive content.","title":"Might Be Offensive","type":"boolean"}},"title":"Extra","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__MetaUrl":{"properties":{"favicon":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The favicon used for the URL.","title":"Favicon"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The lowercased domain name extracted from the URL.","title":"Hostname"},"netloc":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The network location part extracted from the URL.","title":"Netloc"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The hierarchical path of the URL useful as a display string.","title":"Path"},"scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The protocol scheme extracted from the URL.","title":"Scheme"}},"title":"MetaUrl","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__Profile":{"properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The served image URL representing the profile.","title":"Img"},"long_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The long name of the profile.","title":"Long Name"},"name":{"description":"The name of the profile.","title":"Name","type":"string"},"url":{"description":"The original URL where the profile is available.","title":"Url","type":"string"}},"required":["name","url"],"title":"Profile","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__Query":{"properties":{"altered":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The altered query by the spellchecker. This is the query that is used to search if any.","title":"Altered"},"cleaned":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The cleaned normalized query by the spellchecker. This is the query that is used to search if any.","title":"Cleaned"},"original":{"description":"The original query that was requested.","title":"Original","type":"string"},"search_operators":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_SearchOperators"},{"type":"null"}],"description":"Search operators applied to the query."},"show_strict_warning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"The value is true if the lack of results is due to a strict safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch.","title":"Show Strict Warning"},"spellcheck_off":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the spellchecker is enabled or disabled.","title":"Spellcheck Off"}},"required":["original"],"title":"Query","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__Thumbnail":{"properties":{"original":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The original URL of the thumbnail associated with the video.","title":"Original"},"src":{"description":"The served URL of the thumbnail associated with the video.","title":"Src","type":"string"}},"required":["src"],"title":"Thumbnail","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__VideoData":{"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Profile"},{"type":"null"}],"description":"A profile associated with the video."},"creator":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The creator of the video.","title":"Creator"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A time string representing the duration of the video.","title":"Duration"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The publisher of the video.","title":"Publisher"},"requires_subscription":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the video requires a subscription.","title":"Requires Subscription"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"A list of tags relevant to the video.","title":"Tags"},"views":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of views of the video.","title":"Views"}},"title":"VideoData","type":"object"},"Response762Cca4421D2_app__models__products__search__v1__videos__VideoResult":{"properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A human-readable representation of the video’s age. For example, 2 days ago.","title":"Age"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The description for the video.","title":"Description"},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The timestamp when the content was fetched.","title":"Fetched Content Timestamp"},"meta_url":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__MetaUrl"},{"type":"null"}],"description":"Aggregated information on the URL associated with the video search result."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The page’s date, based on its published or last modified date.","title":"Page Age"},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ.","title":"Page Fetched"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Thumbnail"},{"type":"null"}],"description":"The thumbnail for the video."},"title":{"description":"The title of the video.","title":"Title","type":"string"},"type":{"const":"video_result","default":"video_result","description":"The type of video search API result. The value is always video_result.","enum":["video_result"],"title":"Type","type":"string"},"url":{"description":"The source URL of the video.","title":"Url","type":"string"},"video":{"anyOf":[{"$ref":"#/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__VideoData"},{"type":"null"}],"description":"Metadata for the video."}},"required":["url","title"],"title":"VideoResult","type":"object"},"Response762Cca4421D2_snakepit__models__mixer__general__Language":{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},"Response762Cca4421D2_snakepit__models__mixer__specs__atomic__MetaUrl":{"properties":{"favicon":{"title":"Favicon","type":"string"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hostname"},"netloc":{"title":"Netloc","type":"string"},"path":{"title":"Path","type":"string"},"scheme":{"title":"Scheme","type":"string"}},"required":["scheme","netloc","favicon","path"],"title":"MetaUrl","type":"object"},"Response762Cca4421D2_snakepit__models__mixer__specs__items__DataProvider":{"properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img"},"long_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Name"},"name":{"title":"Name","type":"string"},"type":{"default":"external","title":"Type","type":"string"},"url":{"title":"Url","type":"string"}},"required":["name","url"],"title":"DataProvider","type":"object"},"Response762Cca4421D2_snakepit__models__rich_header__results__cryptocurrencies__v1__Quote":{"properties":{"ath":{"title":"Ath","type":"number"},"ath_change_percentage":{"title":"Ath Change Percentage","type":"number"},"ath_date":{"title":"Ath Date","type":"string"},"atl":{"title":"Atl","type":"number"},"atl_change_percentage":{"title":"Atl Change Percentage","type":"number"},"atl_date":{"title":"Atl Date","type":"string"},"circulating_supply":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Circulating Supply"},"current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Price"},"fully_diluted_valuation":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fully Diluted Valuation"},"high_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High 24H"},"id":{"title":"Id","type":"string"},"image":{"title":"Image","type":"string"},"last_updated":{"title":"Last Updated","type":"string"},"low_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low 24H"},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Cap"},"market_cap_change_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Cap Change 24H"},"market_cap_change_percentage_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Cap Change Percentage 24H"},"market_cap_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Market Cap Rank"},"max_supply":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Supply"},"name":{"title":"Name","type":"string"},"price_change_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Change 24H"},"price_change_percentage_24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Change Percentage 24H"},"symbol":{"title":"Symbol","type":"string"},"total_supply":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Supply"},"total_volume":{"title":"Total Volume","type":"number"}},"required":["id","symbol","name","image","current_price","market_cap","market_cap_rank","total_volume","high_24h","low_24h","price_change_24h","price_change_percentage_24h","market_cap_change_24h","market_cap_change_percentage_24h","ath","ath_change_percentage","ath_date","atl","atl_change_percentage","atl_date","last_updated"],"title":"Quote","type":"object"},"Response762Cca4421D2_snakepit__models__rich_header__results__currencies__v1__Query":{"properties":{"amount":{"title":"Amount","type":"number"},"from_currency":{"$ref":"#/components/schemas/Response762Cca4421D2_Currency"},"to_currency":{"$ref":"#/components/schemas/Response762Cca4421D2_Currency"}},"required":["from_currency","to_currency","amount"],"title":"Query","type":"object"},"Response762Cca4421D2_snakepit__models__rich_header__results__stocks__v1__Quote":{"properties":{"change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change"},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change Percent"},"close":{"title":"Close","type":"number"},"company_name":{"title":"Company Name","type":"string"},"currency":{"title":"Currency","type":"string"},"high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High"},"latest_price":{"title":"Latest Price","type":"number"},"latest_update":{"title":"Latest Update","type":"integer"},"low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low"},"market_cap":{"title":"Market Cap","type":"integer"},"open":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open"},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pe Ratio"},"primary_exchange":{"title":"Primary Exchange","type":"string"},"symbol":{"title":"Symbol","type":"string"},"volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Volume"},"week_52_high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Week 52 High"},"week_52_low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Week 52 Low"}},"required":["symbol","company_name","primary_exchange","market_cap","latest_price","close","latest_update","currency"],"title":"Quote","type":"object"},"Response762Cca4421D2_snakepit__models__rich_header__results__weather__v1__Location":{"properties":{"coords":{"$ref":"#/components/schemas/Response762Cca4421D2_Coordinates"},"country":{"title":"Country","type":"string"},"id":{"title":"Id","type":"integer"},"implicit_location":{"default":false,"title":"Implicit Location","type":"boolean"},"name":{"title":"Name","type":"string"},"population":{"title":"Population","type":"integer"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"sunrise":{"title":"Sunrise","type":"integer"},"sunset":{"title":"Sunset","type":"integer"},"tzoffset":{"title":"Tzoffset","type":"integer"}},"required":["id","name","country","coords","population","sunrise","sunset","tzoffset"],"title":"Location","type":"object"},"Response762Cca4421D2_snakepit__models__search_api__responses__local__v1__Location":{"properties":{"coordinates":{"description":"The latitude and longitude of the location.","maxItems":2,"minItems":2,"prefixItems":[{"type":"number"},{"type":"number"}],"title":"Coordinates","type":"array"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The two letter country code of the location.","title":"Country"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the location.","title":"Name"}},"required":["coordinates"],"title":"Location","type":"object"},"Response762Cca4421D2_snakepit__models__search_api__responses__local__v1__Query":{"properties":{"altered":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The altered query by the spellchecker. This is the query that is used to search.","title":"Altered"},"original":{"description":"The original query that was requested.","title":"Original","type":"string"},"show_strict_warning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"The value is true if the lack of results is due to a strict safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch.","title":"Show Strict Warning"},"spellcheck_off":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the spellchecker is enabled or disabled.","title":"Spellcheck Off"}},"required":["original"],"title":"Query","type":"object"},"Response762Cca4421D2_snakepit__models__search_api__specs__atomic__Thumbnail":{"description":"Aggregated details representing a picture thumbnail.","properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The alt text for the thumbnail image.","title":"Alt"},"bg_color":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The background color of the thumbnail.","title":"Bg Color"},"duplicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the thumbnail is a duplicate.","title":"Duplicated"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the thumbnail.","title":"Height"},"logo":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the thumbnail is a logo.","title":"Logo"},"original":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The original URL of the image.","title":"Original"},"src":{"description":"The served URL of the picture thumbnail.","title":"Src","type":"string"},"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The theme of the thumbnail (e.g., light or dark).","title":"Theme"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the thumbnail.","title":"Width"}},"required":["src"],"title":"Thumbnail","type":"object"},"Response7A88Af0Ff8Eb_DepositResponse":{"properties":{"address":{"description":"Bridge addresses for different blockchain networks","properties":{"btc":{"description":"Bitcoin bridge address","example":"bc1q8eau83qffxcj8ht4hsjdza3lha9r3egfqysj3g","type":"string"},"evm":{"description":"EVM-compatible bridge address (Ethereum, Polygon, Arbitrum, Base, etc.)","example":"0x23566f8b2E82aDfCf01846E54899d110e97AC053","type":"string"},"svm":{"description":"Solana Virtual Machine bridge address","example":"CrvTBvzryYxBHbWu2TiQpcqD5M7Le7iBKzVmEj3f36Jb","type":"string"},"tron":{"description":"Tron bridge address","type":"string"}},"type":"object"},"note":{"description":"Additional information about the bridge addresses","example":"Only certain chains and tokens are supported. See /supported-assets for details.","type":"string"}},"type":"object"},"Response7A88Af0Ff8Eb_FeeBreakdown":{"description":"Breakdown of the estimated fees","properties":{"appFeeLabel":{"description":"Label of the app fee","example":"Fun.xyz fee","type":"string"},"appFeePercent":{"description":"App fees as a percentage of the total amount sent","example":0,"type":"number"},"appFeeUsd":{"description":"App fees in USD","example":0,"type":"number"},"fillCostPercent":{"description":"Fill cost percentage of the total amount sent","example":0,"type":"number"},"fillCostUsd":{"description":"Fill cost in USD","example":0,"type":"number"},"gasUsd":{"description":"Gas fee in USD","example":0.003854,"type":"number"},"maxSlippage":{"description":"Maximum potential slippage as a percentage","example":0,"type":"number"},"minReceived":{"description":"Amount after factoring slippage","example":14.488305,"type":"number"},"swapImpact":{"description":"Swap impact as a percentage of the total amount sent","example":0,"type":"number"},"swapImpactUsd":{"description":"Swap impact of the transaction in USD","example":0,"type":"number"},"totalImpact":{"description":"Total impact as a percentage of the total amount sent","example":0,"type":"number"},"totalImpactUsd":{"description":"Impact cost of the transaction","example":0,"type":"number"}},"type":"object"},"Response7A88Af0Ff8Eb_QuoteResponse":{"properties":{"estCheckoutTimeMs":{"description":"Estimated time to complete the checkout in milliseconds","example":25000,"type":"integer"},"estFeeBreakdown":{"$ref":"#/components/schemas/Response7A88Af0Ff8Eb_FeeBreakdown"},"estInputUsd":{"description":"Estimated token amount received in USD","example":14.488305,"type":"number"},"estOutputUsd":{"description":"Estimated token amount sent in USD","example":14.488305,"type":"number"},"estToTokenBaseUnit":{"description":"Estimated token amount received","example":"14491203","type":"string"},"quoteId":{"description":"Unique quote id of the request","example":"0x00c34ba467184b0146406d62b0e60aaa24ed52460bd456222b6155a0d9de0ad5","type":"string"}},"type":"object"},"Response7A88Af0Ff8Eb_SupportedAsset":{"properties":{"chainId":{"description":"Chain ID","example":"1","type":"string"},"chainName":{"description":"Human-readable chain name","example":"Ethereum","type":"string"},"minCheckoutUsd":{"description":"Minimum amount in USD for deposits and withdrawals","example":45,"type":"number"},"token":{"$ref":"#/components/schemas/Response7A88Af0Ff8Eb_Token"}},"type":"object"},"Response7A88Af0Ff8Eb_SupportedAssetsResponse":{"properties":{"supportedAssets":{"description":"List of supported assets with minimum amounts for deposits and withdrawals","items":{"$ref":"#/components/schemas/Response7A88Af0Ff8Eb_SupportedAsset"},"type":"array"}},"type":"object"},"Response7A88Af0Ff8Eb_Token":{"properties":{"address":{"description":"Token contract address","example":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","type":"string"},"decimals":{"description":"Token decimals","example":6,"type":"integer"},"name":{"description":"Full token name","example":"USD Coin","type":"string"},"symbol":{"description":"Token symbol","example":"USDC","type":"string"}},"type":"object"},"Response7A88Af0Ff8Eb_Transaction":{"properties":{"createdTimeMs":{"description":"Unix timestamp in milliseconds when transaction was created (missing when status is DEPOSIT_DETECTED)","example":1757531217339,"type":"number"},"fromAmountBaseUnit":{"description":"Amount in base units (without decimals)","example":"13566635","type":"string"},"fromChainId":{"description":"Source chain ID","example":"1151111081099710","type":"string"},"fromTokenAddress":{"description":"Source token contract address","example":"11111111111111111111111111111111","type":"string"},"status":{"description":"Current status of the transaction. If a transaction fails, remains stuck, or funds are held due to a compliance check, direct users to our Bridge API provider's support (https://intercom.help/funxyz/en/articles/10732578-contact-us).\n","enum":["DEPOSIT_DETECTED","PROCESSING","ORIGIN_TX_CONFIRMED","SUBMITTED","COMPLETED","FAILED"],"example":"COMPLETED","type":"string"},"toChainId":{"description":"Destination chain ID","example":"137","type":"string"},"toTokenAddress":{"description":"Destination token contract address","example":"0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB","type":"string"},"txHash":{"description":"Transaction hash (only available when status is COMPLETED)","example":"3atr19NAiNCYt24RHM1WnzZp47RXskpTDzspJoCBBaMFwUB8fk37hFkxz35P5UEnnmWz21rb2t5wJ8pq3EE2XnxU","type":"string"}},"type":"object"},"Response7A88Af0Ff8Eb_TransactionStatusResponse":{"properties":{"nextCursor":{"description":"Opaque continuation token for the next page, or null when the pagination walk is complete. Pass it back verbatim as `cursor` on the next request; never parse, modify, construct, or reuse it with a different address. Stop on null rather than on an empty page or a page shorter than `limit`.\n","example":"eyJsYXN0SWQiOiI0MiJ9","type":["string","null"]},"transactions":{"description":"One page of transactions for the given address, newest first. This is a page, not the full history for the address.\n","items":{"$ref":"#/components/schemas/Response7A88Af0Ff8Eb_Transaction"},"type":"array"}},"required":["transactions","nextCursor"],"type":"object"},"Response7B51F63Afd06_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response7B6Efb3B471D_BalanceSheet":{"properties":{"accession_number":{"description":"The SEC accession number of the filing.","type":["string","null"]},"accumulated_other_comprehensive_income":{"description":"The accumulated other comprehensive income of the company.","type":"number"},"cash_and_equivalents":{"description":"The cash and equivalents of the company.","type":"number"},"currency":{"description":"The currency in which the financial data is reported.","type":"string"},"current_assets":{"description":"The current assets of the company.","type":"number"},"current_debt":{"description":"The current debt of the company.","type":"number"},"current_investments":{"description":"The current investments of the company.","type":"number"},"current_liabilities":{"description":"The current liabilities of the company.","type":"number"},"deferred_revenue":{"description":"The deferred revenue of the company.","type":"number"},"deposit_liabilities":{"description":"The deposit liabilities of the company.","type":"number"},"filing_date":{"description":"Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row.","format":"date","type":["string","null"]},"filing_datetime":{"description":"Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event).","format":"date-time","type":["string","null"]},"filing_url":{"description":"URL to the SEC filing.","format":"uri","type":["string","null"]},"fiscal_period":{"description":"The fiscal period of the balance sheet.","type":"string"},"form_type":{"description":"The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing.","type":["string","null"]},"goodwill_and_intangible_assets":{"description":"The goodwill and intangible assets of the company.","type":"number"},"inventory":{"description":"The inventory of the company.","type":"number"},"investments":{"description":"The investments of the company.","type":"number"},"non_current_assets":{"description":"The non-current assets of the company.","type":"number"},"non_current_debt":{"description":"The non-current debt of the company.","type":"number"},"non_current_investments":{"description":"The non-current investments of the company.","type":"number"},"non_current_liabilities":{"description":"The non-current liabilities of the company.","type":"number"},"outstanding_shares":{"description":"The outstanding shares of the company.","type":"number"},"period":{"description":"The time period of the balance sheet.","enum":["quarterly","ttm","annual"],"type":"string"},"property_plant_and_equipment":{"description":"The property, plant, and equipment of the company.","type":"number"},"report_period":{"description":"The reporting period of the balance sheet.","format":"date","type":"string"},"retained_earnings":{"description":"The retained earnings of the company.","type":"number"},"shareholders_equity":{"description":"The shareholders' equity of the company.","type":"number"},"tax_assets":{"description":"The tax assets of the company.","type":"number"},"tax_liabilities":{"description":"The tax liabilities of the company.","type":"number"},"ticker":{"description":"The ticker symbol.","type":"string"},"total_assets":{"description":"The total assets of the company.","type":"number"},"total_debt":{"description":"The total debt of the company.","type":"number"},"total_liabilities":{"description":"The total liabilities of the company.","type":"number"},"trade_and_non_trade_payables":{"description":"The trade and non-trade payables of the company.","type":"number"},"trade_and_non_trade_receivables":{"description":"The trade and non-trade receivables of the company.","type":"number"}},"type":"object"},"Response7B6Efb3B471D_BalanceSheetResponse":{"properties":{"balance_sheets":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_BalanceSheet"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_CashFlowStatement":{"properties":{"accession_number":{"description":"The SEC accession number of the filing.","type":["string","null"]},"business_acquisitions_and_disposals":{"description":"The business acquisitions and disposals of the company.","type":"number"},"capital_expenditure":{"description":"The capital expenditure of the company.","type":"number"},"change_in_cash_and_equivalents":{"description":"The change in cash and equivalents of the company.","type":"number"},"currency":{"description":"The currency in which the financial data is reported.","type":"string"},"depreciation_and_amortization":{"description":"The depreciation and amortization of the company.","type":"number"},"dividends_and_other_cash_distributions":{"description":"The dividends and other cash distributions of the company.","type":"number"},"effect_of_exchange_rate_changes":{"description":"The effect of exchange rate changes of the company.","type":"number"},"ending_cash_balance":{"description":"The ending cash balance of the company.","type":"number"},"filing_date":{"description":"Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row.","format":"date","type":["string","null"]},"filing_datetime":{"description":"Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event).","format":"date-time","type":["string","null"]},"filing_url":{"description":"URL to the SEC filing.","format":"uri","type":["string","null"]},"fiscal_period":{"description":"The fiscal period of the cash flow statement.","type":"string"},"form_type":{"description":"The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing.","type":["string","null"]},"free_cash_flow":{"description":"The free cash flow of the company.","type":"number"},"investment_acquisitions_and_disposals":{"description":"The investment acquisitions and disposals of the company.","type":"number"},"issuance_or_purchase_of_equity_shares":{"description":"The issuance or purchase of equity shares of the company.","type":"number"},"issuance_or_repayment_of_debt_securities":{"description":"The issuance or repayment of debt securities of the company.","type":"number"},"net_cash_flow_from_financing":{"description":"The net cash flow from financing of the company.","type":"number"},"net_cash_flow_from_investing":{"description":"The net cash flow from investing of the company.","type":"number"},"net_cash_flow_from_operations":{"description":"The net cash flow from operations of the company.","type":"number"},"net_income":{"description":"The net income of the company.","type":"number"},"period":{"description":"The time period of the cash flow statement.","enum":["quarterly","ttm","annual"],"type":"string"},"report_period":{"description":"The reporting period of the cash flow statement.","format":"date","type":"string"},"share_based_compensation":{"description":"The share-based compensation of the company.","type":"number"},"ticker":{"description":"The ticker symbol.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_CashFlowStatementResponse":{"properties":{"cash_flow_statements":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_CashFlowStatement"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_CompanyFacts":{"properties":{"cik":{"description":"The Central Index Key (CIK) of the company.","type":"string"},"exchange":{"description":"The exchange of the company.","type":"string"},"industry":{"description":"The industry of the company.","type":"string"},"is_active":{"description":"Whether the company is currently active.","type":"boolean"},"location":{"description":"The location of the company.","type":"string"},"name":{"description":"The name of the company.","type":"string"},"sec_filings_url":{"description":"The URL of the company's SEC filings.","format":"uri","type":"string"},"sector":{"description":"The sector of the company.","type":"string"},"sic_code":{"description":"The Standard Industrial Classification (SIC) code of the company.","type":"string"},"sic_industry":{"description":"The industry of the company based on the SIC code.","type":"string"},"sic_sector":{"description":"The sector of the company based on the SIC code.","type":"string"},"ticker":{"description":"The ticker symbol of the company.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_CompanyFactsResponse":{"properties":{"company_facts":{"$ref":"#/components/schemas/Response7B6Efb3B471D_CompanyFacts"}},"type":"object"},"Response7B6Efb3B471D_EarningsRecord":{"properties":{"accession_number":{"description":"SEC accession number identifying the filing.","type":"string"},"annual":{"$ref":"#/components/schemas/Response7B6Efb3B471D_EarningsTimeDimension"},"currency":{"description":"ISO currency code (e.g. USD).","type":"string"},"filing_date":{"description":"Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`.","format":"date","type":"string"},"filing_datetime":{"description":"Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event).","format":"date-time","type":["string","null"]},"filing_url":{"description":"URL to the SEC filing.","format":"uri","type":"string"},"filing_window":{"description":"Market session at the moment SEC accepted the filing, evaluated in Eastern Time. PRE_MARKET = weekday 04:00–09:30 ET. DURING_MARKET = weekday 09:30–16:00 ET. AFTER_HOURS = weekday outside regular trading hours. WEEKEND = Saturday or Sunday. Null when filing_datetime is unavailable.","enum":["PRE_MARKET","DURING_MARKET","AFTER_HOURS","WEEKEND"],"type":["string","null"]},"fiscal_period":{"description":"Fiscal period label (e.g. 2026-Q1 or 2025-FY).","type":"string"},"quarterly":{"$ref":"#/components/schemas/Response7B6Efb3B471D_EarningsTimeDimension"},"report_period":{"description":"Report period this filing covers.","format":"date","type":"string"},"signals":{"description":"Curated, market-moving insights distilled from this filing. Each item has a pre-rendered `headline`, structured `details`, and an `importance` ranking. Returned only when at least one signal fires for this entry; field is omitted otherwise. Capped at 8 per entry, ordered HIGH → MEDIUM → LOW.","items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_Signal"},"type":"array"},"source_type":{"description":"The SEC form type backing this filing.","enum":["8-K","10-Q","10-K","20-F"],"type":"string"},"ticker":{"description":"The requested ticker symbol.","type":"string"}},"required":["ticker","report_period","source_type","filing_date","filing_url","accession_number"],"type":"object"},"Response7B6Efb3B471D_EarningsResponse":{"properties":{"earnings":{"description":"Flat list of SEC filings for the ticker, sorted by (report_period DESC, filing_date ASC). When `limit=N`, up to N report_periods worth of filings are returned; entry count may exceed N when a recent period has both an 8-K and a 10-Q/10-K.","items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_EarningsRecord"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_EarningsTimeDimension":{"properties":{"capital_expenditure":{"type":["number","null"]},"capital_expenditure_chg":{"description":"Percentage change in capital expenditure versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"capital_expenditure_yoy_chg":{"description":"Year-over-year change in capital expenditure versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"cash_and_equivalents":{"type":["number","null"]},"change_in_cash_and_equivalents":{"type":["number","null"]},"earnings_per_share":{"type":["number","null"]},"earnings_per_share_chg":{"description":"Percentage change in EPS versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"earnings_per_share_yoy_chg":{"description":"Year-over-year change in EPS versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"free_cash_flow":{"type":["number","null"]},"free_cash_flow_chg":{"description":"Percentage change in free cash flow versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"free_cash_flow_yoy_chg":{"description":"Year-over-year change in free cash flow versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"gross_margin":{"description":"Gross margin as a decimal (gross_profit / revenue). Returned only when calculable.","type":"number"},"gross_margin_chg_bps":{"description":"Absolute change in gross margin versus the prior period in basis points (e.g. 200.0 = margin expanded 200 bps). Returned only when calculable.","type":"number"},"gross_margin_chg_pct":{"description":"Percentage change in gross margin versus the prior period as a decimal. Returned only when calculable.","type":"number"},"gross_margin_yoy_chg_bps":{"description":"Year-over-year change in gross margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable.","type":"number"},"gross_margin_yoy_chg_pct":{"description":"Year-over-year percentage change in gross margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"gross_profit":{"type":["number","null"]},"gross_profit_chg":{"description":"Percentage change in gross profit versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"gross_profit_yoy_chg":{"description":"Year-over-year change in gross profit versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"net_cash_flow_from_financing":{"type":["number","null"]},"net_cash_flow_from_financing_chg":{"description":"Percentage change in net cash flow from financing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"net_cash_flow_from_financing_yoy_chg":{"description":"Year-over-year change in net cash flow from financing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"net_cash_flow_from_investing":{"type":["number","null"]},"net_cash_flow_from_investing_chg":{"description":"Percentage change in net cash flow from investing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"net_cash_flow_from_investing_yoy_chg":{"description":"Year-over-year change in net cash flow from investing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"net_cash_flow_from_operations":{"type":["number","null"]},"net_cash_flow_from_operations_chg":{"description":"Percentage change in net cash flow from operations versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"net_cash_flow_from_operations_yoy_chg":{"description":"Year-over-year change in net cash flow from operations versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"net_income":{"type":["number","null"]},"net_income_chg":{"description":"Percentage change in net income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"net_income_yoy_chg":{"description":"Year-over-year change in net income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"net_margin":{"description":"Net margin as a decimal (net_income / revenue). Returned only when calculable.","type":"number"},"net_margin_chg_bps":{"description":"Absolute change in net margin versus the prior period in basis points. Returned only when calculable.","type":"number"},"net_margin_chg_pct":{"description":"Percentage change in net margin versus the prior period as a decimal. Returned only when calculable.","type":"number"},"net_margin_yoy_chg_bps":{"description":"Year-over-year change in net margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable.","type":"number"},"net_margin_yoy_chg_pct":{"description":"Year-over-year percentage change in net margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"operating_income":{"type":["number","null"]},"operating_income_chg":{"description":"Percentage change in operating income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"operating_income_yoy_chg":{"description":"Year-over-year change in operating income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"operating_margin":{"description":"Operating margin as a decimal (operating_income / revenue). Returned only when calculable.","type":"number"},"operating_margin_chg_bps":{"description":"Absolute change in operating margin versus the prior period in basis points. Returned only when calculable.","type":"number"},"operating_margin_chg_pct":{"description":"Percentage change in operating margin versus the prior period as a decimal. Returned only when calculable.","type":"number"},"operating_margin_yoy_chg_bps":{"description":"Year-over-year change in operating margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable.","type":"number"},"operating_margin_yoy_chg_pct":{"description":"Year-over-year percentage change in operating margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"revenue":{"type":["number","null"]},"revenue_chg":{"description":"Percentage change in revenue versus the prior period as a decimal (e.g. 0.10 = +10%). Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable.","type":"number"},"revenue_yoy_chg":{"description":"Year-over-year change in revenue versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable.","type":"number"},"shareholders_equity":{"type":["number","null"]},"total_assets":{"type":["number","null"]},"total_debt":{"type":["number","null"]},"total_liabilities":{"type":["number","null"]},"weighted_average_shares":{"type":["number","null"]},"weighted_average_shares_diluted":{"type":["number","null"]}},"type":"object"},"Response7B6Efb3B471D_Exhibit":{"properties":{"description":{"description":"The description of the exhibit.","type":"string"},"number":{"description":"The exhibit number (e.g., '99.1').","type":"string"},"text":{"description":"The raw text content of the exhibit. Only included when 'include_exhibits' parameter is set to true.","type":"string"},"url":{"description":"The URL to the exhibit document on the SEC website.","format":"uri","type":"string"}},"type":"object"},"Response7B6Efb3B471D_Filing":{"properties":{"accession_number":{"description":"The accession number of the filing.","type":"string"},"cik":{"description":"The Central Index Key (CIK) of the company.","type":"integer"},"filing_date":{"description":"The date the filing was submitted to the SEC.","format":"date","type":"string"},"filing_type":{"description":"The type of the SEC filing (e.g., 10-Q, 8-K).","type":"string"},"report_date":{"description":"The date of the report.","format":"date","type":"string"},"ticker":{"description":"The ticker symbol.","type":"string"},"url":{"description":"The URL of the SEC filing.","format":"uri","type":"string"}},"type":"object"},"Response7B6Efb3B471D_FilingItem":{"properties":{"exhibits":{"description":"An array of exhibits linked to this item. Only present for 8-K filings when exhibits exist.","items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_Exhibit"},"type":"array"},"name":{"description":"The item name.","type":"string"},"number":{"description":"The item number.","type":"string"},"text":{"description":"The item text.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_FilingItemsAccepted":{"properties":{"accession_number":{"description":"The accession number of the filing being prepared.","type":"string"},"estimated_ready_at":{"description":"When the filing is expected to be ready.","format":"date-time","type":"string"},"message":{"description":"Human-readable description of what to do next.","type":"string"},"request_id":{"description":"Identifier for this request; useful when contacting support.","format":"uuid","type":"string"},"result_url":{"description":"The URL to poll for the result.","type":"string"},"status":{"description":"Always 'processing' on a 202 response.","enum":["processing"],"type":"string"}},"type":"object"},"Response7B6Efb3B471D_FilingItemsResponse":{"properties":{"accession_number":{"description":"The accession number of the filing.","type":"string"},"cik":{"description":"The Central Index Key (CIK) of the company.","type":"string"},"filing_type":{"description":"The type of filing.","type":"string"},"items":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_FilingItem"},"type":"array"},"quarter":{"description":"The quarter of the filing.","type":"integer"},"resource":{"description":"The resource type identifier.","type":"string"},"ticker":{"description":"The ticker symbol of the company.","type":"string"},"year":{"description":"The year of the filing.","type":"integer"}},"type":"object"},"Response7B6Efb3B471D_FilingsResponse":{"properties":{"filings":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_Filing"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_FinancialMetricSnapshot":{"properties":{"asset_turnover":{"description":"Revenue divided by average total assets.","type":["number","null"]},"book_value_growth":{"description":"Year-over-year growth in book value.","type":["number","null"]},"book_value_per_share":{"description":"Shareholders' equity divided by shares outstanding.","type":["number","null"]},"cash_ratio":{"description":"Cash and cash equivalents divided by current liabilities.","type":["number","null"]},"currency":{"description":"The currency in which the financial data is reported.","type":["string","null"]},"current_ratio":{"description":"Current assets divided by current liabilities.","type":["number","null"]},"days_sales_outstanding":{"description":"Average accounts receivable divided by revenue over the period.","type":["number","null"]},"debt_to_assets":{"description":"Total debt divided by total assets.","type":["number","null"]},"debt_to_equity":{"description":"Total debt divided by shareholders' equity.","type":["number","null"]},"earnings_growth":{"description":"Year-over-year growth in earnings.","type":["number","null"]},"earnings_per_share":{"description":"Net income divided by weighted average shares outstanding.","type":["number","null"]},"earnings_per_share_growth":{"description":"Growth in earnings per share over the period.","type":["number","null"]},"ebitda_growth":{"description":"Growth in EBITDA over the period.","type":["number","null"]},"enterprise_value":{"description":"The total value of the company (market cap + debt - cash).","type":["number","null"]},"enterprise_value_to_ebitda_ratio":{"description":"Enterprise value to EBITDA ratio.","type":["number","null"]},"enterprise_value_to_revenue_ratio":{"description":"Enterprise value to revenue ratio.","type":["number","null"]},"free_cash_flow_growth":{"description":"Growth in free cash flow over the period.","type":["number","null"]},"free_cash_flow_per_share":{"description":"Free cash flow divided by shares outstanding.","type":["number","null"]},"free_cash_flow_yield":{"description":"Free cash flow yield.","type":["number","null"]},"gross_margin":{"description":"Gross profit as a percentage of revenue.","type":["number","null"]},"interest_coverage":{"description":"EBIT divided by interest expense.","type":["number","null"]},"inventory_turnover":{"description":"Cost of goods sold divided by average inventory.","type":["number","null"]},"market_cap":{"description":"The total market capitalization (stock price × shares outstanding).","type":["number","null"]},"net_margin":{"description":"Net income as a percentage of revenue.","type":["number","null"]},"operating_cash_flow_ratio":{"description":"Operating cash flow divided by current liabilities.","type":["number","null"]},"operating_cycle":{"description":"Inventory turnover + receivables turnover.","type":["number","null"]},"operating_income_growth":{"description":"Growth in operating income over the period.","type":["number","null"]},"operating_margin":{"description":"Operating income as a percentage of revenue.","type":["number","null"]},"payout_ratio":{"description":"Dividends paid as a percentage of net income.","type":["number","null"]},"peg_ratio":{"description":"Price to earnings growth ratio.","type":["number","null"]},"price_to_book_ratio":{"description":"Price to book ratio.","type":["number","null"]},"price_to_earnings_ratio":{"description":"Price to earnings ratio.","type":["number","null"]},"price_to_sales_ratio":{"description":"Price to sales ratio.","type":["number","null"]},"quick_ratio":{"description":"Quick assets divided by current liabilities.","type":["number","null"]},"receivables_turnover":{"description":"Revenue divided by average accounts receivable.","type":["number","null"]},"return_on_assets":{"description":"Net income as a percentage of total assets.","type":["number","null"]},"return_on_equity":{"description":"Net income as a percentage of shareholders' equity.","type":["number","null"]},"return_on_invested_capital":{"description":"Net operating profit after taxes as a percentage of invested capital.","type":["number","null"]},"revenue_growth":{"description":"Year-over-year growth in revenue.","type":["number","null"]},"ticker":{"description":"The ticker symbol of the company.","type":"string"},"working_capital_turnover":{"description":"Revenue divided by average working capital.","type":["number","null"]}},"type":"object"},"Response7B6Efb3B471D_FinancialMetricSnapshotResponse":{"properties":{"snapshot":{"$ref":"#/components/schemas/Response7B6Efb3B471D_FinancialMetricSnapshot"}},"type":"object"},"Response7B6Efb3B471D_FinancialMetricsResponse":{"properties":{"accession_number":{"description":"The SEC accession number of the filing.","type":["string","null"]},"asset_turnover":{"description":"Revenue divided by average total assets.","type":"number"},"book_value_growth":{"description":"Year-over-year growth in book value.","type":"number"},"book_value_per_share":{"description":"Shareholders' equity divided by shares outstanding.","type":"number"},"cash_ratio":{"description":"Cash and cash equivalents divided by current liabilities.","type":"number"},"currency":{"description":"The currency in which the financial data is reported.","type":"string"},"current_ratio":{"description":"Current assets divided by current liabilities.","type":"number"},"days_sales_outstanding":{"description":"Average accounts receivable divided by revenue over the period.","type":"number"},"debt_to_assets":{"description":"Total debt divided by total assets.","type":"number"},"debt_to_equity":{"description":"Total debt divided by shareholders' equity.","type":"number"},"earnings_growth":{"description":"Year-over-year growth in earnings.","type":"number"},"earnings_per_share":{"description":"Net income divided by weighted average shares outstanding.","type":"number"},"earnings_per_share_growth":{"description":"Growth in earnings per share over the period.","type":"number"},"ebitda_growth":{"description":"Growth in EBITDA over the period.","type":"number"},"enterprise_value":{"description":"The total value of the company (market cap + debt - cash).","type":"number"},"enterprise_value_to_ebitda_ratio":{"description":"Enterprise value to EBITDA ratio.","type":"number"},"enterprise_value_to_revenue_ratio":{"description":"Enterprise value to revenue ratio.","type":"number"},"filing_date":{"description":"Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row.","format":"date","type":["string","null"]},"filing_datetime":{"description":"Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event).","format":"date-time","type":["string","null"]},"filing_url":{"description":"URL to the SEC filing.","format":"uri","type":["string","null"]},"fiscal_period":{"description":"The fiscal period of the financial metrics.","type":"string"},"form_type":{"description":"The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing.","type":["string","null"]},"free_cash_flow_growth":{"description":"Growth in free cash flow over the period.","type":"number"},"free_cash_flow_per_share":{"description":"Free cash flow divided by shares outstanding.","type":"number"},"free_cash_flow_yield":{"description":"Free cash flow yield.","type":"number"},"gross_margin":{"description":"Gross profit as a percentage of revenue.","type":"number"},"interest_coverage":{"description":"EBIT divided by interest expense.","type":"number"},"inventory_turnover":{"description":"Cost of goods sold divided by average inventory.","type":"number"},"net_margin":{"description":"Net income as a percentage of revenue.","type":"number"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"},"operating_cash_flow_ratio":{"description":"Operating cash flow divided by current liabilities.","type":"number"},"operating_cycle":{"description":"Inventory turnover + receivables turnover.","type":"number"},"operating_income_growth":{"description":"Growth in operating income over the period.","type":"number"},"operating_margin":{"description":"Operating income as a percentage of revenue.","type":"number"},"payout_ratio":{"description":"Dividends paid as a percentage of net income.","type":"number"},"peg_ratio":{"description":"Price to earnings growth ratio.","type":"number"},"period":{"description":"The time period of the financial metrics.","enum":["quarterly","ttm","annual"],"type":"string"},"price_to_book_ratio":{"description":"Price to book ratio.","type":"number"},"price_to_earnings_ratio":{"description":"Price to earnings ratio.","type":"number"},"price_to_sales_ratio":{"description":"Price to sales ratio.","type":"number"},"quick_ratio":{"description":"Quick assets divided by current liabilities.","type":"number"},"receivables_turnover":{"description":"Revenue divided by average accounts receivable.","type":"number"},"report_period":{"description":"The reporting period of the financial metrics.","format":"date","type":"string"},"return_on_assets":{"description":"Net income as a percentage of total assets.","type":"number"},"return_on_equity":{"description":"Net income as a percentage of shareholders' equity.","type":"number"},"return_on_invested_capital":{"description":"Net operating profit after taxes as a percentage of invested capital.","type":"number"},"revenue_growth":{"description":"Year-over-year growth in revenue.","type":"number"},"ticker":{"description":"The ticker symbol of the company.","type":"string"},"working_capital_turnover":{"description":"Revenue divided by average working capital.","type":"number"}},"type":"object"},"Response7B6Efb3B471D_FinancialsResponse":{"properties":{"financials":{"properties":{"balance_sheets":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_BalanceSheet"},"type":"array"},"cash_flow_statements":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_CashFlowStatement"},"type":"array"},"income_statements":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_IncomeStatement"},"type":"array"}},"type":"object"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_FinancialsSearchResponse":{"properties":{"search_results":{"items":{"additionalProperties":{"description":"Additional financial metrics based on the search criteria.","type":"string"},"properties":{"currency":{"description":"The currency of the financial data.","type":"string"},"period":{"description":"The time period of the financial data.","enum":["annual","quarterly","ttm"],"type":"string"},"report_period":{"description":"The reporting period of the financial data.","format":"date","type":"string"},"ticker":{"description":"The ticker symbol of the company.","type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"Response7B6Efb3B471D_IncomeStatement":{"properties":{"accession_number":{"description":"The SEC accession number of the filing.","type":["string","null"]},"consolidated_income":{"description":"The consolidated income of the company.","type":"number"},"cost_of_revenue":{"description":"The cost of revenue of the company.","type":"number"},"currency":{"description":"The currency in which the financial data is reported.","type":"string"},"dividends_per_common_share":{"description":"The dividends per common share of the company.","type":"number"},"earnings_per_share":{"description":"The earnings per share of the company.","type":"number"},"earnings_per_share_diluted":{"description":"The diluted earnings per share of the company.","type":"number"},"ebit":{"description":"The earnings before interest and taxes of the company.","type":"number"},"filing_date":{"description":"Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row.","format":"date","type":["string","null"]},"filing_datetime":{"description":"Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event).","format":"date-time","type":["string","null"]},"filing_url":{"description":"URL to the SEC filing.","format":"uri","type":["string","null"]},"fiscal_period":{"description":"The fiscal period of the income statement.","type":"string"},"form_type":{"description":"The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing.","type":["string","null"]},"gross_profit":{"description":"The gross profit of the company.","type":"number"},"income_tax_expense":{"description":"The income tax expenses of the company.","type":"number"},"interest_expense":{"description":"The interest expenses of the company.","type":"number"},"net_income":{"description":"The net income of the company.","type":"number"},"net_income_common_stock":{"description":"The net income available to common stockholders of the company.","type":"number"},"net_income_discontinued_operations":{"description":"The net income from discontinued operations of the company.","type":"number"},"net_income_non_controlling_interests":{"description":"The net income from non-controlling interests of the company.","type":"number"},"operating_expense":{"description":"The operating expenses of the company.","type":"number"},"operating_income":{"description":"The operating income of the company.","type":"number"},"period":{"description":"The time period of the income statement.","enum":["quarterly","ttm","annual"],"type":"string"},"preferred_dividends_impact":{"description":"The impact of preferred dividends on the net income of the company.","type":"number"},"report_period":{"description":"The reporting period of the income statement.","format":"date","type":"string"},"research_and_development":{"description":"The research and development expenses of the company.","type":"number"},"revenue":{"description":"The total revenue of the company.","type":"number"},"selling_general_and_administrative_expenses":{"description":"The selling, general, and administrative expenses of the company.","type":"number"},"ticker":{"description":"The ticker symbol.","type":"string"},"weighted_average_shares":{"description":"The weighted average shares of the company.","type":"number"},"weighted_average_shares_diluted":{"description":"The diluted weighted average shares of the company.","type":"number"}},"type":"object"},"Response7B6Efb3B471D_IncomeStatementResponse":{"properties":{"income_statements":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_IncomeStatement"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_InsiderTrade":{"properties":{"filing_date":{"description":"The date the filing was accepted by the SEC.","format":"date","type":"string"},"form_type":{"description":"The SEC form type: 4 (trade report) or 5 (annual statement), or their amendments 4/A, 5/A.","type":"string"},"is_board_director":{"description":"Whether the insider is a board director.","type":"boolean"},"issuer":{"description":"The name of the issuing company.","type":"string"},"name":{"description":"The name of the insider.","type":"string"},"report_period":{"description":"The reporting period declared on the filing. For Form 4 this is the date of the earliest transaction reported, and it may be earlier than the filing_date.","format":"date","type":"string"},"security_title":{"description":"The title of the security involved in the transaction.","type":"string"},"shares_owned_after_transaction":{"description":"The number of shares owned after the transaction.","type":"number"},"shares_owned_before_transaction":{"description":"The number of shares owned before the transaction.","type":"number"},"ticker":{"description":"The ticker symbol of the company.","type":"string"},"title":{"description":"The title of the insider.","type":"string"},"transaction_code":{"description":"The SEC Form 4 transaction code (for example, `P` for open market purchase, `S` for open market sale, `M` for exercise of derivative securities, `F` for shares withheld to cover taxes, `G` for gift). Distinguishes the individual legs of a multi-part filing.","type":"string"},"transaction_date":{"description":"The date of the transaction.","format":"date","type":"string"},"transaction_price_per_share":{"description":"The price per share in the transaction.","type":"number"},"transaction_shares":{"description":"The number of shares involved in the transaction.","type":"number"},"transaction_type":{"description":"A human-readable description of the transaction, derived from the transaction_code.","type":"string"},"transaction_value":{"description":"The total value of the transaction.","type":"number"}},"type":"object"},"Response7B6Efb3B471D_InsiderTradesResponse":{"properties":{"insider_trades":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_InsiderTrade"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_InterestRate":{"properties":{"bank":{"description":"The symbol of the central bank.","type":"string"},"date":{"description":"The calendar day the rate is in effect, in YYYY-MM-DD format.","type":"string"},"name":{"description":"The name of the central bank.","type":"string"},"rate":{"description":"The policy rate in percent on that day. For the Federal Reserve, the midpoint of the target range.","type":"number"}},"type":"object"},"Response7B6Efb3B471D_InterestRatesResponse":{"properties":{"interest_rates":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_InterestRate"},"type":"array"},"next_page_url":{"description":"History only. Absolute URL of the next page of results. Present only when more rows remain; request it as-is to continue. Each page holds up to 10 rows.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_KPIGuidanceItem":{"properties":{"change_direction":{"description":"Direction: raised, lowered, maintained, initiated, withdrawn.","example":"initiated","type":["string","null"]},"high":{"description":"High end of guidance range.","example":8,"type":["number","null"]},"low":{"description":"Low end of guidance range.","example":6,"type":["number","null"]},"metric_name":{"example":"Operating Margin","type":"string"},"period":{"example":"Q2 2026","type":"string"},"period_type":{"enum":["quarterly","annual"],"type":"string"},"point_estimate":{"description":"Single-point guidance when no range is given.","type":["number","null"]},"prior_value":{"description":"Prior guidance value for revisions.","type":["number","null"]},"raw_text":{"description":"Original guidance text from the filing.","type":["string","null"]},"segment":{"type":["string","null"]},"source_text":{"type":["string","null"]},"source_url":{"format":"uri","type":["string","null"]},"ticker":{"example":"DAL","type":"string"},"unit":{"example":"%","type":"string"},"value":{"type":["number","null"]}},"required":["ticker","metric_name","period","period_type"],"type":"object"},"Response7B6Efb3B471D_KPIGuidanceResponse":{"properties":{"kpi_guidance":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_KPIGuidanceItem"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_KPIMetric":{"properties":{"metric_name":{"description":"Canonical metric name.","example":"load_factor","type":"string"},"period":{"description":"Reporting period (e.g., Q4 2025, FY 2025, or a date like 2025-04-30 for non-standard fiscal years).","example":"Q4 2025","type":"string"},"period_type":{"description":"Whether this is a quarterly or annual figure.","enum":["quarterly","annual"],"example":"quarterly","type":"string"},"segment":{"description":"Business segment, geography, or sub-category. Only present when the metric is reported for a sub-unit rather than the consolidated entity.","example":"Commercial Engines & Services","type":["string","null"]},"source_text":{"description":"The source text span from the filing where this value was found.","example":"Passenger load factor","type":["string","null"]},"source_url":{"description":"Direct link to the SEC filing. When available, includes a text fragment that highlights the source in the browser.","example":"https://www.sec.gov/Archives/edgar/data/27904/000002790426000008/deltaairlinesannouncesdece.htm","format":"uri","type":"string"},"ticker":{"description":"Stock ticker symbol.","example":"DAL","type":"string"},"unit":{"description":"Unit of measure (e.g., %, cents, dollars, miles, count).","example":"%","type":"string"},"value":{"description":"Extracted numeric value.","example":82,"type":["number","null"]},"yoy_change_pct":{"description":"Year-over-year percentage change.","example":-2.381,"type":["number","null"]},"yoy_value":{"description":"Year-over-year comparison value from the prior period.","example":84,"type":["number","null"]}},"required":["ticker","metric_name","value","unit","period","period_type"],"type":"object"},"Response7B6Efb3B471D_KPIMetricsResponse":{"properties":{"kpi_metrics":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_KPIMetric"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_KPINonGAAPMetric":{"properties":{"gaap_equivalent":{"description":"The GAAP line item this metric adjusts.","example":"Diluted earnings per share","type":["string","null"]},"key_adjustments":{"description":"Description of adjustments made.","example":"Excludes restructuring charges of $150M","type":["string","null"]},"metric_name":{"example":"Adjusted Diluted EPS","type":"string"},"period":{"example":"Q1 2026","type":"string"},"period_type":{"enum":["quarterly","annual"],"type":"string"},"source_text":{"type":["string","null"]},"source_url":{"format":"uri","type":["string","null"]},"ticker":{"example":"DAL","type":"string"},"unit":{"example":"USD per share","type":"string"},"value":{"example":0.64,"type":["number","null"]}},"required":["ticker","metric_name","value","unit","period","period_type"],"type":"object"},"Response7B6Efb3B471D_KPINonGAAPResponse":{"properties":{"kpi_non_gaap":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_KPINonGAAPMetric"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_News":{"properties":{"date":{"description":"The date the news article was published.","format":"date","type":"string"},"source":{"description":"The source of the news article.","type":"string"},"ticker":{"description":"The ticker symbol.","type":"string"},"title":{"description":"The title of the news article.","type":"string"},"url":{"description":"The URL of the news article.","format":"uri","type":"string"}},"type":"object"},"Response7B6Efb3B471D_NewsResponse":{"properties":{"news":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_News"},"type":"array"},"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_Price":{"properties":{"close":{"description":"The close price of the ticker in the given time period.","type":"number"},"high":{"description":"The high price of the ticker in the given time period.","type":"number"},"low":{"description":"The low price of the ticker in the given time period.","type":"number"},"open":{"description":"The open price of the ticker in the given time period.","type":"number"},"time":{"description":"The human-readable time format of the price in UTC.","type":"string"},"volume":{"description":"The trading volume of the ticker in the given time period.","type":["integer","null"]}},"type":"object"},"Response7B6Efb3B471D_PriceSnapshot":{"properties":{"day_change":{"description":"The price change since the previous trading day's close.","type":"number"},"day_change_percent":{"description":"The percentage price change since the previous trading day's close.","type":"number"},"price":{"description":"The current price of the stock.","type":"number"},"ticker":{"description":"The ticker symbol.","type":"string"},"time":{"description":"The timestamp of the price snapshot in human-readable format in UTC.","type":"string"},"time_milliseconds":{"description":"The timestamp of the price snapshot in milliseconds since epoch.","type":"number"}},"type":"object"},"Response7B6Efb3B471D_PriceSnapshotResponse":{"properties":{"snapshot":{"$ref":"#/components/schemas/Response7B6Efb3B471D_PriceSnapshot"}},"type":"object"},"Response7B6Efb3B471D_PricesResponse":{"properties":{"next_page_url":{"description":"Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 100 records.","type":"string"},"prices":{"items":{"$ref":"#/components/schemas/Response7B6Efb3B471D_Price"},"type":"array"},"ticker":{"description":"The ticker symbol.","type":"string"}},"type":"object"},"Response7B6Efb3B471D_Signal":{"description":"A curated market-moving insight derived from this filing. Pre-rendered `headline` is suitable for direct display; `details` carries structured fields for filtering and programmatic use. Signals are returned in priority order (most material first); the `type` itself encodes magnitude (e.g. `STRONG_REVENUE_INCREASE` vs `REVENUE_INCREASE`).","properties":{"details":{"additionalProperties":true,"description":"Structured fields specific to the signal type. Contents vary: guidance signals carry `low`, `high`, `point_estimate`, `prior_value`, `revision_pct`; segment signals carry `best`, `worst`, `spread_pp`; non-GAAP signals carry `gaap_field`, `non_gaap_value`, `gaap_value`, `divergence_pct`; growth signals carry `current`, `yoy_chg`. Null values are omitted. Refer to type-specific examples.","type":"object"},"headline":{"description":"Pre-rendered, human-readable summary suitable for direct display.","type":"string"},"metric":{"description":"The metric this signal references, when applicable (e.g. `revenue`, `earnings_per_share`, `operating_margin`, or a guidance/KPI metric name).","type":["string","null"]},"period":{"description":"The fiscal period the signal references (e.g. `2026-Q1`, `FY 2026`). Forward guidance signals reference the guided period; financial signals reference the reporting period of this filing.","type":["string","null"]},"type":{"description":"Signal category. MARGIN_EXPANSION/MARGIN_CONTRACTION: any of gross/operating/net margin moved year-over-year by ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: forward-looking guidance change reported in the filing. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: best- or worst-performing reportable segment by organic revenue growth. NON_GAAP_DIVERGENCE: an adjusted/non-GAAP figure differs materially from its GAAP counterpart on the same period. BACKLOG_SURGE/BACKLOG_DECLINE: backlog or remaining performance obligations moved year-over-year by ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE and DECLINE variants: tiered year-over-year revenue change (≥10% / ≥20% magnitude). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE and DECLINE variants: tiered year-over-year net income change (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE and DECLINE variants: tiered year-over-year EPS change (≥15% / ≥30%); independent from net income because share buybacks can amplify EPS movement. CAPEX_INCREASE/STRONG_CAPEX_INCREASE and DECLINE variants: tiered year-over-year capital expenditure change in spending magnitude (≥15% / ≥30%).","enum":["MARGIN_EXPANSION","MARGIN_CONTRACTION","GUIDANCE_RAISED","GUIDANCE_LOWERED","GUIDANCE_REAFFIRMED","GUIDANCE_INITIATED","SEGMENT_OUTPERFORMANCE","SEGMENT_UNDERPERFORMANCE","NON_GAAP_DIVERGENCE","BACKLOG_SURGE","BACKLOG_DECLINE","REVENUE_INCREASE","REVENUE_DECLINE","STRONG_REVENUE_INCREASE","STRONG_REVENUE_DECLINE","NET_INCOME_INCREASE","NET_INCOME_DECLINE","STRONG_NET_INCOME_INCREASE","STRONG_NET_INCOME_DECLINE","EPS_INCREASE","EPS_DECLINE","STRONG_EPS_INCREASE","STRONG_EPS_DECLINE","CAPEX_INCREASE","CAPEX_DECLINE","STRONG_CAPEX_INCREASE","STRONG_CAPEX_DECLINE"],"type":"string"}},"required":["type","headline"],"type":"object"},"Response80775Eb82C8B_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response860C3Ae68Ea5_Categories":{"items":{"properties":{"content":{"description":"Category description","type":"string"},"id":{"description":"Category ID","type":"string"},"market_cap":{"description":"Category market cap","type":"number"},"market_cap_change_24h":{"description":"Category market cap change in 24 hours","type":"number"},"name":{"description":"Category name","type":"string"},"top_3_coins":{"description":"Image URLs of top 3 coins in the category","items":{"type":"string"},"type":"array"},"top_3_coins_id":{"description":"IDs of top 3 coins in the category","items":{"type":"string"},"type":"array"},"updated_at":{"description":"Category last updated timestamp","type":"string"},"volume_24h":{"description":"Category trading volume in 24 hours","type":"number"}},"required":["id","name","market_cap","market_cap_change_24h","content","top_3_coins_id","top_3_coins","volume_24h","updated_at"],"type":"object"},"type":"array"},"Response860C3Ae68Ea5_CategoriesList":{"items":{"properties":{"category_id":{"description":"Category ID","type":"string"},"name":{"description":"Category name","type":"string"}},"required":["category_id","name"],"type":"object"},"type":"array"},"Response860C3Ae68Ea5_CoinsContractAddress":{"properties":{"additional_notices":{"description":"Additional notices","items":{"type":"string"},"type":"array"},"asset_platform_id":{"description":"Coin asset platform ID","type":["string","null"]},"block_time_in_minutes":{"description":"Blockchain block time in minutes","type":"number"},"categories":{"description":"Coin categories","items":{"type":"string"},"type":"array"},"contract_address":{"description":"Coin contract address","type":"string"},"country_origin":{"description":"Country of origin","type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"Coin description","type":"object"},"detail_platforms":{"additionalProperties":{"properties":{"contract_address":{"description":"Token contract address","type":"string"},"decimal_place":{"description":"Token decimal place","type":["integer","null"]},"geckoterminal_url":{"description":"GeckoTerminal URL","type":"string"}},"type":"object"},"description":"Detailed coin asset platform and contract address","type":"object"},"genesis_date":{"description":"Genesis date","type":["string","null"]},"has_supply_breakdown":{"description":"Whether detailed supply breakdown data is available via /coins/supply_breakdown","type":"boolean"},"hashing_algorithm":{"description":"Blockchain hashing algorithm","type":["string","null"]},"id":{"description":"Coin ID","type":"string"},"image":{"description":"Coin image URL","properties":{"large":{"type":"string"},"small":{"type":"string"},"thumb":{"type":"string"}},"type":"object"},"last_updated":{"description":"Last updated timestamp","type":"string"},"links":{"description":"Links","properties":{"announcement_url":{"description":"Announcement URL","items":{"type":"string"},"type":"array"},"bitcointalk_thread_identifier":{"description":"Bitcointalk thread identifier","type":["integer","null"]},"blockchain_site":{"description":"Block explorer URL","items":{"type":"string"},"type":"array"},"chat_url":{"description":"Chat URL","items":{"type":"string"},"type":"array"},"facebook_username":{"description":"Facebook username","type":"string"},"homepage":{"description":"Website URL","items":{"type":"string"},"type":"array"},"official_forum_url":{"description":"Official forum URL","items":{"type":"string"},"type":"array"},"repos_url":{"description":"Repository URL","properties":{"bitbucket":{"description":"Bitbucket repository URL","items":{"type":"string"},"type":"array"},"github":{"description":"GitHub repository URL","items":{"type":"string"},"type":"array"}},"type":"object"},"snapshot_url":{"description":"Snapshot URL","type":["string","null"]},"subreddit_url":{"description":"Subreddit URL","type":["string","null"]},"telegram_channel_identifier":{"description":"Telegram channel identifier","type":"string"},"twitter_screen_name":{"description":"Twitter handle","type":"string"},"whitepaper":{"description":"Whitepaper URL","type":"string"}},"type":"object"},"localization":{"additionalProperties":{"type":"string"},"description":"Coin name localization","type":"object"},"market_cap_rank":{"description":"Market cap rank","type":["integer","null"]},"market_cap_rank_with_rehypothecated":{"description":"Market cap rank including rehypothecated tokens","type":["integer","null"]},"market_data":{"description":"Market data","properties":{"ath":{"additionalProperties":{"type":"number"},"description":"All-time high in target currency","type":"object"},"ath_change_percentage":{"additionalProperties":{"type":"number"},"description":"All-time high change percentage","type":"object"},"ath_date":{"additionalProperties":{"type":"string"},"description":"All-time high date","type":"object"},"atl":{"additionalProperties":{"type":"number"},"description":"All-time low in target currency","type":"object"},"atl_change_percentage":{"additionalProperties":{"type":"number"},"description":"All-time low change percentage","type":"object"},"atl_date":{"additionalProperties":{"type":"string"},"description":"All-time low date","type":"object"},"circulating_supply":{"description":"Circulating supply","type":"number"},"current_price":{"additionalProperties":{"type":"number"},"description":"Current price in target currency","type":"object"},"fdv_to_tvl_ratio":{"description":"FDV to TVL ratio","type":["number","null"]},"fully_diluted_valuation":{"additionalProperties":{"type":"number"},"description":"Fully diluted valuation in target currency","type":"object"},"high_24h":{"additionalProperties":{"type":"number"},"description":"24h price high in target currency","type":"object"},"last_updated":{"description":"Market data last updated timestamp","type":"string"},"low_24h":{"additionalProperties":{"type":"number"},"description":"24h price low in target currency","type":"object"},"market_cap":{"additionalProperties":{"type":"number"},"description":"Market cap in target currency","type":"object"},"market_cap_change_24h":{"description":"24h market cap change in target currency","type":"number"},"market_cap_change_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h market cap change in target currency","type":"object"},"market_cap_change_percentage_24h":{"description":"24h market cap change percentage","type":"number"},"market_cap_change_percentage_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h market cap change percentage per currency","type":"object"},"market_cap_fdv_ratio":{"description":"Market cap to FDV ratio","type":"number"},"market_cap_rank":{"description":"Market cap rank","type":["integer","null"]},"market_cap_rank_with_rehypothecated":{"description":"Market cap rank including rehypothecated tokens","type":["integer","null"]},"max_supply":{"description":"Max supply","type":["number","null"]},"max_supply_infinite":{"description":"Max supply infinite","type":"boolean"},"mcap_to_tvl_ratio":{"description":"Market cap to TVL ratio","type":["number","null"]},"outstanding_supply":{"description":"Tokens outstanding in the market","type":["number","null"]},"outstanding_token_value_usd":{"description":"Outstanding token value in USD","type":["number","null"]},"price_change_24h":{"description":"24h price change in target currency","type":"number"},"price_change_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h price change in target currency","type":"object"},"price_change_percentage_14d":{"description":"14d price change percentage","type":"number"},"price_change_percentage_14d_in_currency":{"additionalProperties":{"type":"number"},"description":"14d price change percentage per currency","type":"object"},"price_change_percentage_1h_in_currency":{"additionalProperties":{"type":"number"},"description":"1h price change percentage per currency","type":"object"},"price_change_percentage_1y":{"description":"1y price change percentage","type":"number"},"price_change_percentage_1y_in_currency":{"additionalProperties":{"type":"number"},"description":"1y price change percentage per currency","type":"object"},"price_change_percentage_200d":{"description":"200d price change percentage","type":"number"},"price_change_percentage_200d_in_currency":{"additionalProperties":{"type":"number"},"description":"200d price change percentage per currency","type":"object"},"price_change_percentage_24h":{"description":"24h price change percentage","type":"number"},"price_change_percentage_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h price change percentage per currency","type":"object"},"price_change_percentage_30d":{"description":"30d price change percentage","type":"number"},"price_change_percentage_30d_in_currency":{"additionalProperties":{"type":"number"},"description":"30d price change percentage per currency","type":"object"},"price_change_percentage_60d":{"description":"60d price change percentage","type":"number"},"price_change_percentage_60d_in_currency":{"additionalProperties":{"type":"number"},"description":"60d price change percentage per currency","type":"object"},"price_change_percentage_7d":{"description":"7d price change percentage","type":"number"},"price_change_percentage_7d_in_currency":{"additionalProperties":{"type":"number"},"description":"7d price change percentage per currency","type":"object"},"roi":{"description":"Return on investment","properties":{"currency":{"description":"ROI currency","type":"string"},"percentage":{"description":"ROI percentage","type":"number"},"times":{"description":"ROI multiplier","type":"number"}},"type":["object","null"]},"sparkline_7d":{"description":"Sparkline 7-day price data","items":{"type":"number"},"type":"array"},"total_supply":{"description":"Total supply","type":"number"},"total_value_locked":{"description":"Total value locked","type":["number","null"]},"total_volume":{"additionalProperties":{"type":"number"},"description":"Total trading volume in target currency","type":"object"}},"type":"object"},"name":{"description":"Coin name","type":"string"},"platforms":{"additionalProperties":{"type":"string"},"description":"Coin asset platform and contract address","type":"object"},"preview_listing":{"description":"Preview listing coin","type":"boolean"},"public_notice":{"description":"Public notice","type":["string","null"]},"sentiment_votes_down_percentage":{"description":"Sentiment votes down percentage","type":["number","null"]},"sentiment_votes_up_percentage":{"description":"Sentiment votes up percentage","type":["number","null"]},"status_updates":{"description":"Status updates","items":{"properties":{"category":{"description":"Status update category","type":"string"},"created_at":{"description":"Status update creation time","type":"string"},"description":{"description":"Status update description","type":"string"},"user":{"description":"Status update user","type":"string"},"user_title":{"description":"Status update user title","type":"string"}},"type":"object"},"type":"array"},"symbol":{"description":"Coin symbol","type":"string"},"tickers":{"description":"Tickers","items":{"properties":{"base":{"description":"Ticker base currency","type":"string"},"bid_ask_spread_percentage":{"description":"Ticker bid-ask spread percentage","type":"number"},"coin_id":{"description":"Ticker base currency coin ID","type":"string"},"coin_mcap_usd":{"description":"Market cap in USD","type":"number"},"converted_last":{"description":"Ticker converted last price","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"converted_volume":{"description":"Ticker converted volume","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"is_anomaly":{"description":"Ticker anomaly","type":"boolean"},"is_stale":{"description":"Ticker stale","type":"boolean"},"last":{"description":"Ticker last price","type":"number"},"last_fetch_at":{"description":"Ticker last fetch timestamp","type":"string"},"last_traded_at":{"description":"Ticker last traded timestamp","type":"string"},"market":{"description":"Ticker exchange","properties":{"has_trading_incentive":{"description":"Exchange trading incentive","type":"boolean"},"identifier":{"description":"Exchange identifier","type":"string"},"name":{"description":"Exchange name","type":"string"}},"type":"object"},"target":{"description":"Ticker target currency","type":"string"},"target_coin_id":{"description":"Ticker target currency coin ID","type":"string"},"timestamp":{"description":"Ticker timestamp","type":"string"},"token_info_url":{"description":"Ticker token info URL","type":["string","null"]},"trade_url":{"description":"Ticker trade URL","type":"string"},"trust_score":{"description":"Ticker trust score","type":["string","null"]},"volume":{"description":"Ticker volume","type":"number"}},"type":"object"},"type":"array"},"watchlist_portfolio_users":{"description":"Number of users watching this coin in portfolio","type":"number"},"web_slug":{"description":"Coin web slug","type":"string"}},"required":["id","symbol","name","web_slug","asset_platform_id","platforms","detail_platforms","block_time_in_minutes","hashing_algorithm","categories","preview_listing","public_notice","additional_notices","has_supply_breakdown","description","links","image","country_origin","genesis_date","contract_address","sentiment_votes_up_percentage","sentiment_votes_down_percentage","watchlist_portfolio_users","market_cap_rank","market_cap_rank_with_rehypothecated","status_updates","last_updated"],"type":"object"},"Response860C3Ae68Ea5_CoinsID":{"properties":{"additional_notices":{"description":"Additional notices","items":{"type":"string"},"type":"array"},"asset_platform_id":{"description":"Coin asset platform ID","type":["string","null"]},"block_time_in_minutes":{"description":"Blockchain block time in minutes","type":"number"},"categories":{"description":"Coin categories","items":{"type":"string"},"type":"array"},"categories_details":{"description":"Detailed coin categories","items":{"properties":{"id":{"description":"Category ID","type":"string"},"name":{"description":"Category name","type":"string"}},"type":"object"},"type":"array"},"country_origin":{"description":"Country of origin","type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"Coin description","type":"object"},"detail_platforms":{"additionalProperties":{"properties":{"contract_address":{"description":"Token contract address","type":"string"},"decimal_place":{"description":"Token decimal place","type":["integer","null"]}},"type":"object"},"description":"Detailed coin asset platform and contract address","type":"object"},"genesis_date":{"description":"Genesis date","type":["string","null"]},"has_supply_breakdown":{"description":"Whether detailed supply breakdown data is available via /coins/supply_breakdown","type":"boolean"},"hashing_algorithm":{"description":"Blockchain hashing algorithm","type":["string","null"]},"ico_data":{"description":"ICO data","properties":{"accepting_currencies":{"description":"Accepting currencies","type":"string"},"amount_for_sale":{"description":"Amount for sale","type":"number"},"base_pre_sale_amount":{"description":"Base pre-sale amount","type":"number"},"base_public_sale_amount":{"description":"Base public sale amount","type":"number"},"bounty_detail_url":{"description":"Bounty detail URL","type":"string"},"country_origin":{"description":"Country of origin","type":"string"},"description":{"description":"Detailed description","type":"string"},"hardcap_amount":{"description":"Hardcap amount","type":"number"},"hardcap_currency":{"description":"Hardcap currency","type":"string"},"ico_end_date":{"description":"ICO end date","type":"string"},"ico_start_date":{"description":"ICO start date","type":"string"},"kyc_required":{"description":"KYC required","type":"boolean"},"links":{"additionalProperties":{"type":"string"},"description":"ICO related links","type":"object"},"pre_sale_available":{"description":"Pre-sale available","type":"boolean"},"pre_sale_end_date":{"description":"Pre-sale end date","type":"string"},"pre_sale_ended":{"description":"Pre-sale ended","type":"boolean"},"pre_sale_start_date":{"description":"Pre-sale start date","type":"string"},"quote_pre_sale_amount":{"description":"Quote pre-sale amount","type":"number"},"quote_pre_sale_currency":{"description":"Quote pre-sale currency","type":"string"},"quote_public_sale_amount":{"description":"Quote public sale amount","type":"number"},"quote_public_sale_currency":{"description":"Quote public sale currency","type":"string"},"short_desc":{"description":"Short description","type":"string"},"softcap_amount":{"description":"Softcap amount","type":"number"},"softcap_currency":{"description":"Softcap currency","type":"string"},"total_raised":{"description":"Total raised amount","type":"number"},"total_raised_currency":{"description":"Total raised currency","type":"string"},"whitelist_available":{"description":"Whitelist available","type":"boolean"},"whitelist_end_date":{"description":"Whitelist end date","type":"string"},"whitelist_start_date":{"description":"Whitelist start date","type":"string"},"whitelist_url":{"description":"Whitelist URL","type":"string"}},"type":["object","null"]},"id":{"description":"Coin ID","type":"string"},"image":{"description":"Coin image URL","properties":{"large":{"type":"string"},"small":{"type":"string"},"thumb":{"type":"string"}},"type":"object"},"last_updated":{"description":"Last updated timestamp","type":"string"},"links":{"description":"Links","properties":{"announcement_url":{"description":"Announcement URL","items":{"type":"string"},"type":"array"},"bitcointalk_thread_identifier":{"description":"Bitcointalk thread identifier","type":["integer","null"]},"blockchain_site":{"description":"Block explorer URL","items":{"type":"string"},"type":"array"},"chat_url":{"description":"Chat URL","items":{"type":"string"},"type":"array"},"facebook_username":{"description":"Facebook username","type":"string"},"homepage":{"description":"Website URL","items":{"type":"string"},"type":"array"},"official_forum_url":{"description":"Official forum URL","items":{"type":"string"},"type":"array"},"repos_url":{"description":"Repository URL","properties":{"bitbucket":{"description":"Bitbucket repository URL","items":{"type":"string"},"type":"array"},"github":{"description":"GitHub repository URL","items":{"type":"string"},"type":"array"}},"type":"object"},"snapshot_url":{"description":"Snapshot URL","type":["string","null"]},"subreddit_url":{"description":"Subreddit URL","type":"string"},"telegram_channel_identifier":{"description":"Telegram channel identifier","type":"string"},"twitter_screen_name":{"description":"Twitter handle","type":"string"},"whitepaper":{"description":"Whitepaper URL","type":"string"}},"type":"object"},"localization":{"additionalProperties":{"type":"string"},"description":"Coin name localization","type":"object"},"market_cap_rank":{"description":"Market cap rank","type":["integer","null"]},"market_cap_rank_with_rehypothecated":{"description":"Market cap rank including rehypothecated tokens","type":["integer","null"]},"market_data":{"description":"Market data","properties":{"ath":{"additionalProperties":{"type":"number"},"description":"All-time high in target currency","type":"object"},"ath_change_percentage":{"additionalProperties":{"type":"number"},"description":"All-time high change percentage","type":"object"},"ath_date":{"additionalProperties":{"type":"string"},"description":"All-time high date","type":"object"},"atl":{"additionalProperties":{"type":"number"},"description":"All-time low in target currency","type":"object"},"atl_change_percentage":{"additionalProperties":{"type":"number"},"description":"All-time low change percentage","type":"object"},"atl_date":{"additionalProperties":{"type":"string"},"description":"All-time low date","type":"object"},"circulating_supply":{"description":"Circulating supply","type":"number"},"current_price":{"additionalProperties":{"type":"number"},"description":"Current price in target currency","type":"object"},"fdv_to_tvl_ratio":{"description":"FDV to TVL ratio","type":["number","null"]},"fully_diluted_valuation":{"additionalProperties":{"type":"number"},"description":"Fully diluted valuation in target currency","type":"object"},"high_24h":{"additionalProperties":{"type":"number"},"description":"24h price high in target currency","type":"object"},"last_updated":{"description":"Market data last updated timestamp","type":"string"},"low_24h":{"additionalProperties":{"type":"number"},"description":"24h price low in target currency","type":"object"},"market_cap":{"additionalProperties":{"type":"number"},"description":"Market cap in target currency","type":"object"},"market_cap_change_24h":{"description":"24h market cap change in target currency","type":"number"},"market_cap_change_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h market cap change in target currency","type":"object"},"market_cap_change_percentage_24h":{"description":"24h market cap change percentage","type":"number"},"market_cap_change_percentage_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h market cap change percentage per currency","type":"object"},"market_cap_fdv_ratio":{"description":"Market cap to FDV ratio","type":"number"},"market_cap_rank":{"description":"Market cap rank","type":["integer","null"]},"market_cap_rank_with_rehypothecated":{"description":"Market cap rank including rehypothecated tokens","type":["integer","null"]},"max_supply":{"description":"Max supply","type":["number","null"]},"max_supply_infinite":{"description":"Max supply infinite","type":"boolean"},"mcap_to_tvl_ratio":{"description":"Market cap to TVL ratio","type":["number","null"]},"outstanding_supply":{"description":"Tokens outstanding in the market","type":["number","null"]},"outstanding_token_value_usd":{"description":"Outstanding token value in USD","type":["number","null"]},"price_change_24h":{"description":"24h price change in target currency","type":"number"},"price_change_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h price change in target currency","type":"object"},"price_change_percentage_14d":{"description":"14d price change percentage","type":"number"},"price_change_percentage_14d_in_currency":{"additionalProperties":{"type":"number"},"description":"14d price change percentage per currency","type":"object"},"price_change_percentage_1h_in_currency":{"additionalProperties":{"type":"number"},"description":"1h price change percentage per currency","type":"object"},"price_change_percentage_1y":{"description":"1y price change percentage","type":"number"},"price_change_percentage_1y_in_currency":{"additionalProperties":{"type":"number"},"description":"1y price change percentage per currency","type":"object"},"price_change_percentage_200d":{"description":"200d price change percentage","type":"number"},"price_change_percentage_200d_in_currency":{"additionalProperties":{"type":"number"},"description":"200d price change percentage per currency","type":"object"},"price_change_percentage_24h":{"description":"24h price change percentage","type":"number"},"price_change_percentage_24h_in_currency":{"additionalProperties":{"type":"number"},"description":"24h price change percentage per currency","type":"object"},"price_change_percentage_30d":{"description":"30d price change percentage","type":"number"},"price_change_percentage_30d_in_currency":{"additionalProperties":{"type":"number"},"description":"30d price change percentage per currency","type":"object"},"price_change_percentage_60d":{"description":"60d price change percentage","type":"number"},"price_change_percentage_60d_in_currency":{"additionalProperties":{"type":"number"},"description":"60d price change percentage per currency","type":"object"},"price_change_percentage_7d":{"description":"7d price change percentage","type":"number"},"price_change_percentage_7d_in_currency":{"additionalProperties":{"type":"number"},"description":"7d price change percentage per currency","type":"object"},"roi":{"description":"Return on investment","properties":{"currency":{"description":"ROI currency","type":"string"},"percentage":{"description":"ROI percentage","type":"number"},"times":{"description":"ROI multiplier","type":"number"}},"type":["object","null"]},"sparkline_7d":{"description":"Sparkline 7-day price data","items":{"type":"number"},"type":"array"},"total_supply":{"description":"Total supply","type":"number"},"total_value_locked":{"description":"Total value locked","type":["number","null"]},"total_volume":{"additionalProperties":{"type":"number"},"description":"Total trading volume in target currency","type":"object"}},"type":"object"},"name":{"description":"Coin name","type":"string"},"platforms":{"additionalProperties":{"type":"string"},"description":"Coin asset platform and contract address","type":"object"},"preview_listing":{"description":"Preview listing coin","type":"boolean"},"public_notice":{"description":"Public notice","type":["string","null"]},"sentiment_votes_down_percentage":{"description":"Sentiment votes down percentage","type":["number","null"]},"sentiment_votes_up_percentage":{"description":"Sentiment votes up percentage","type":["number","null"]},"status_updates":{"description":"Status updates","items":{"properties":{"category":{"description":"Status update category","type":"string"},"created_at":{"description":"Status update creation time","type":"string"},"description":{"description":"Status update description","type":"string"},"user":{"description":"Status update user","type":"string"},"user_title":{"description":"Status update user title","type":"string"}},"type":"object"},"type":"array"},"symbol":{"description":"Coin symbol","type":"string"},"tickers":{"description":"Tickers","items":{"properties":{"base":{"description":"Ticker base currency","type":"string"},"bid_ask_spread_percentage":{"description":"Ticker bid-ask spread percentage","type":"number"},"coin_id":{"description":"Ticker base currency coin ID","type":"string"},"coin_mcap_usd":{"description":"Market cap in USD","type":"number"},"converted_last":{"description":"Ticker converted last price","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"converted_volume":{"description":"Ticker converted volume","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"is_anomaly":{"description":"Ticker anomaly","type":"boolean"},"is_stale":{"description":"Ticker stale","type":"boolean"},"last":{"description":"Ticker last price","type":"number"},"last_fetch_at":{"description":"Ticker last fetch timestamp","type":"string"},"last_traded_at":{"description":"Ticker last traded timestamp","type":"string"},"market":{"description":"Ticker exchange","properties":{"has_trading_incentive":{"description":"Exchange trading incentive","type":"boolean"},"identifier":{"description":"Exchange identifier","type":"string"},"name":{"description":"Exchange name","type":"string"}},"type":"object"},"target":{"description":"Ticker target currency","type":"string"},"target_coin_id":{"description":"Ticker target currency coin ID","type":"string"},"timestamp":{"description":"Ticker timestamp","type":"string"},"token_info_url":{"description":"Ticker token info URL","type":["string","null"]},"trade_url":{"description":"Ticker trade URL","type":"string"},"trust_score":{"description":"Ticker trust score","type":["string","null"]},"volume":{"description":"Ticker volume","type":"number"}},"type":"object"},"type":"array"},"watchlist_portfolio_users":{"description":"Number of users watching this coin in portfolio","type":"number"},"web_slug":{"description":"Coin web slug","type":"string"}},"required":["id","symbol","name","web_slug","asset_platform_id","platforms","detail_platforms","block_time_in_minutes","hashing_algorithm","categories","preview_listing","public_notice","additional_notices","has_supply_breakdown","description","links","image","country_origin","genesis_date","sentiment_votes_up_percentage","sentiment_votes_down_percentage","watchlist_portfolio_users","market_cap_rank","market_cap_rank_with_rehypothecated","status_updates","last_updated"],"type":"object"},"Response860C3Ae68Ea5_CoinsIdHistory":{"properties":{"id":{"description":"Coin ID","type":"string"},"image":{"description":"Coin image URLs","properties":{"small":{"description":"Small image URL","type":"string"},"thumb":{"description":"Thumbnail image URL","type":"string"}},"type":"object"},"localization":{"additionalProperties":{"type":"string"},"description":"Localized coin names keyed by locale code","type":"object"},"market_data":{"description":"Market data at the given date","properties":{"current_price":{"additionalProperties":{"type":"number"},"description":"Current price keyed by currency","type":"object"},"market_cap":{"additionalProperties":{"type":"number"},"description":"Market capitalization keyed by currency","type":"object"},"total_volume":{"additionalProperties":{"type":"number"},"description":"Total trading volume keyed by currency","type":"object"}},"type":"object"},"name":{"description":"Coin name","type":"string"},"public_interest_stats":{"description":"Public interest statistics","properties":{"alexa_rank":{"description":"Alexa rank","type":["number","null"]},"bing_matches":{"description":"Bing search matches","type":["number","null"]}},"type":"object"},"symbol":{"description":"Coin symbol","type":"string"}},"required":["id","symbol","name","image","market_data","public_interest_stats"],"type":"object"},"Response860C3Ae68Ea5_CoinsIdTickers":{"properties":{"name":{"description":"Coin name","type":"string"},"tickers":{"description":"List of tickers","items":{"properties":{"base":{"description":"Ticker base currency","type":"string"},"bid_ask_spread_percentage":{"description":"Bid-ask spread percentage","type":"number"},"coin_id":{"description":"Base currency coin ID","type":"string"},"coin_mcap_usd":{"description":"Coin market cap in USD","type":"number"},"converted_last":{"description":"Converted last price","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"converted_volume":{"description":"Converted trading volume","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"cost_to_move_down_usd":{"description":"Cost to move price down by 2% in USD","type":"number"},"cost_to_move_up_usd":{"description":"Cost to move price up by 2% in USD","type":"number"},"is_anomaly":{"description":"Whether ticker is anomalous","type":"boolean"},"is_stale":{"description":"Whether ticker is stale","type":"boolean"},"last":{"description":"Last price","type":"number"},"last_fetch_at":{"description":"Last fetch timestamp","type":"string"},"last_traded_at":{"description":"Last traded timestamp","type":"string"},"market":{"description":"Exchange information","properties":{"has_trading_incentive":{"description":"Exchange trading incentive","type":"boolean"},"identifier":{"description":"Exchange identifier","type":"string"},"logo":{"description":"Exchange logo URL","type":"string"},"name":{"description":"Exchange name","type":"string"}},"type":"object"},"target":{"description":"Ticker target currency","type":"string"},"target_coin_id":{"description":"Target currency coin ID","type":"string"},"timestamp":{"description":"Ticker timestamp","type":"string"},"token_info_url":{"description":"Token info URL","type":["string","null"]},"trade_url":{"description":"Trade URL","type":"string"},"trust_score":{"description":"Trust score","type":["string","null"]},"volume":{"description":"Trading volume","type":"number"}},"required":["base","target","market","last","volume","converted_last","converted_volume","trust_score","bid_ask_spread_percentage","timestamp","last_traded_at","last_fetch_at","is_anomaly","is_stale","trade_url","token_info_url","coin_id","target_coin_id","coin_mcap_usd"],"type":"object"},"type":"array"}},"required":["name","tickers"],"type":"object"},"Response860C3Ae68Ea5_CoinsList":{"items":{"properties":{"id":{"description":"Coin ID","type":"string"},"name":{"description":"Coin name","type":"string"},"platforms":{"additionalProperties":{"type":["string","null"]},"description":"Asset platform and contract address","type":"object"},"symbol":{"description":"Coin symbol","type":"string"}},"required":["id","symbol","name"],"type":"object"},"type":"array"},"Response860C3Ae68Ea5_CoinsMarketChart":{"properties":{"market_caps":{"description":"Market cap data points as [timestamp, market_cap] pairs","items":{"items":{"type":"number"},"type":"array"},"type":"array"},"prices":{"description":"Price data points as [timestamp, price] pairs","items":{"items":{"type":"number"},"type":"array"},"type":"array"},"total_volumes":{"description":"Total volume data points as [timestamp, volume] pairs","items":{"items":{"type":"number"},"type":"array"},"type":"array"}},"required":["prices","market_caps","total_volumes"],"type":"object"},"Response860C3Ae68Ea5_CoinsMarkets":{"items":{"properties":{"ath":{"description":"All-time high price in target currency","type":["number","null"]},"ath_change_percentage":{"description":"All-time high change percentage","type":["number","null"]},"ath_date":{"description":"All-time high date","format":"date-time","type":["string","null"]},"atl":{"description":"All-time low price in target currency","type":["number","null"]},"atl_change_percentage":{"description":"All-time low change percentage","type":["number","null"]},"atl_date":{"description":"All-time low date","format":"date-time","type":["string","null"]},"circulating_supply":{"description":"Circulating supply","type":["number","null"]},"current_price":{"description":"Current price in target currency","type":["number","null"]},"fully_diluted_valuation":{"description":"Fully diluted valuation in target currency","type":["number","null"]},"high_24h":{"description":"24-hour price high in target currency","type":["number","null"]},"id":{"description":"Coin ID","type":"string"},"image":{"description":"Coin image URL","type":"string"},"last_updated":{"description":"Last updated timestamp","format":"date-time","type":"string"},"low_24h":{"description":"24-hour price low in target currency","type":["number","null"]},"market_cap":{"description":"Market cap in target currency","type":["number","null"]},"market_cap_change_24h":{"description":"24-hour market cap change in target currency","type":["number","null"]},"market_cap_change_percentage_24h":{"description":"24-hour market cap change percentage","type":["number","null"]},"market_cap_rank":{"description":"Market cap rank","type":["integer","null"]},"market_cap_rank_with_rehypothecated":{"description":"Market cap rank including rehypothecated tokens","type":["integer","null"]},"max_supply":{"description":"Max supply","type":["number","null"]},"name":{"description":"Coin name","type":"string"},"price_change_24h":{"description":"24-hour price change in target currency","type":["number","null"]},"price_change_percentage_14d_in_currency":{"description":"14-day price change percentage in target currency","type":["number","null"]},"price_change_percentage_1h_in_currency":{"description":"1-hour price change percentage in target currency","type":["number","null"]},"price_change_percentage_1y_in_currency":{"description":"1-year price change percentage in target currency","type":["number","null"]},"price_change_percentage_200d_in_currency":{"description":"200-day price change percentage in target currency","type":["number","null"]},"price_change_percentage_24h":{"description":"24-hour price change percentage","type":["number","null"]},"price_change_percentage_24h_in_currency":{"description":"24-hour price change percentage in target currency","type":["number","null"]},"price_change_percentage_30d_in_currency":{"description":"30-day price change percentage in target currency","type":["number","null"]},"price_change_percentage_7d_in_currency":{"description":"7-day price change percentage in target currency","type":["number","null"]},"roi":{"description":"Return on investment data","properties":{"currency":{"description":"ROI currency","type":"string"},"percentage":{"description":"ROI percentage","type":"number"},"times":{"description":"ROI multiplier","type":"number"}},"type":["object","null"]},"sparkline_in_7d":{"description":"Sparkline price data for the last 7 days","properties":{"price":{"description":"Array of price values","items":{"type":"number"},"type":"array"}},"type":"object"},"symbol":{"description":"Coin symbol","type":"string"},"total_supply":{"description":"Total supply","type":["number","null"]},"total_volume":{"description":"Total trading volume in target currency","type":["number","null"]}},"required":["id","symbol","name","image","current_price","market_cap","market_cap_rank","fully_diluted_valuation","total_volume","high_24h","low_24h","price_change_24h","price_change_percentage_24h","market_cap_change_24h","market_cap_change_percentage_24h","circulating_supply","total_supply","max_supply","ath","ath_change_percentage","ath_date","atl","atl_change_percentage","atl_date","roi","last_updated"],"type":"object"},"type":"array"},"Response860C3Ae68Ea5_CoinsOHLC":{"description":"OHLC data points as [timestamp, open, high, low, close] arrays","items":{"items":{"type":"number"},"type":"array"},"type":"array"},"Response860C3Ae68Ea5_ExchangeVolumeChart":{"description":"Volume chart data points as [timestamp, volume_in_btc] pairs","items":{"items":{"oneOf":[{"type":"number"},{"type":"string"}]},"type":"array"},"type":"array"},"Response860C3Ae68Ea5_Exchanges":{"items":{"properties":{"country":{"description":"Country where the exchange is based","type":["string","null"]},"description":{"description":"Exchange description","type":"string"},"has_trading_incentive":{"description":"Whether the exchange has trading incentive","type":"boolean"},"id":{"description":"Exchange ID","type":"string"},"image":{"description":"Exchange logo URL","type":"string"},"name":{"description":"Exchange name","type":"string"},"trade_volume_24h_btc":{"description":"Exchange 24h trading volume in BTC","type":"number"},"trust_score":{"description":"Exchange trust score","type":["number","null"]},"trust_score_rank":{"description":"Exchange trust score rank","type":["number","null"]},"url":{"description":"Exchange website URL","type":"string"},"year_established":{"description":"Year the exchange was established","type":["number","null"]}},"required":["id","name","year_established","country","description","url","image","has_trading_incentive","trust_score","trust_score_rank","trade_volume_24h_btc"],"type":"object"},"type":"array"},"Response860C3Ae68Ea5_ExchangesId":{"properties":{"alert_notice":{"description":"Alert notice","type":"string"},"centralized":{"description":"Whether the exchange is centralized","type":"boolean"},"coins":{"description":"Number of coins listed","type":"number"},"country":{"description":"Country where the exchange is based","type":["string","null"]},"description":{"description":"Exchange description","type":"string"},"facebook_url":{"description":"Facebook URL","type":"string"},"has_trading_incentive":{"description":"Whether the exchange has trading incentive","type":"boolean"},"image":{"description":"Exchange logo URL","type":"string"},"name":{"description":"Exchange name","type":"string"},"other_url_1":{"description":"Other URL 1","type":"string"},"other_url_2":{"description":"Other URL 2","type":"string"},"pairs":{"description":"Number of trading pairs","type":"number"},"public_notice":{"description":"Public notice","type":"string"},"reddit_url":{"description":"Reddit URL","type":"string"},"slack_url":{"description":"Slack URL","type":"string"},"status_updates":{"description":"Status updates","items":{"properties":{"category":{"description":"Status update category","type":"string"},"created_at":{"description":"Status update creation time","type":"string"},"description":{"description":"Status update description","type":"string"},"pin":{"description":"Whether status update is pinned","type":"boolean"},"project":{"description":"Project information","properties":{"id":{"description":"Project ID","type":"string"},"image":{"description":"Project image URLs","properties":{"large":{"type":"string"},"small":{"type":"string"},"thumb":{"type":"string"}},"type":"object"},"name":{"description":"Project name","type":"string"},"type":{"description":"Project type","type":"string"}},"type":"object"},"user":{"description":"Status update user","type":"string"},"user_title":{"description":"Status update user title","type":"string"}},"type":"object"},"type":"array"},"telegram_url":{"description":"Telegram URL","type":"string"},"tickers":{"description":"Exchange tickers","items":{"properties":{"base":{"description":"Ticker base currency","type":"string"},"bid_ask_spread_percentage":{"description":"Bid-ask spread percentage","type":"number"},"coin_id":{"description":"Base currency coin ID","type":"string"},"coin_mcap_usd":{"description":"Coin market cap in USD","type":"number"},"converted_last":{"description":"Converted last price","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"converted_volume":{"description":"Converted trading volume","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"usd":{"type":"number"}},"type":"object"},"is_anomaly":{"description":"Whether ticker is anomalous","type":"boolean"},"is_stale":{"description":"Whether ticker is stale","type":"boolean"},"last":{"description":"Last price","type":"number"},"last_fetch_at":{"description":"Last fetch timestamp","type":"string"},"last_traded_at":{"description":"Last traded timestamp","type":"string"},"market":{"description":"Exchange information","properties":{"has_trading_incentive":{"description":"Exchange trading incentive","type":"boolean"},"identifier":{"description":"Exchange identifier","type":"string"},"name":{"description":"Exchange name","type":"string"}},"type":"object"},"target":{"description":"Ticker target currency","type":"string"},"target_coin_id":{"description":"Target currency coin ID","type":"string"},"timestamp":{"description":"Ticker timestamp","type":"string"},"token_info_url":{"description":"Token info URL","type":["string","null"]},"trade_url":{"description":"Trade URL","type":"string"},"trust_score":{"description":"Trust score","type":["string","null"]},"volume":{"description":"Trading volume","type":"number"}},"type":"object"},"type":"array"},"trade_volume_24h_btc":{"description":"Exchange 24h trading volume in BTC","type":"number"},"trust_score":{"description":"Exchange trust score","type":["number","null"]},"trust_score_rank":{"description":"Exchange trust score rank","type":["number","null"]},"twitter_handle":{"description":"Twitter handle","type":"string"},"url":{"description":"Exchange website URL","type":"string"},"year_established":{"description":"Year the exchange was established","type":["number","null"]}},"required":["name","year_established","country","description","url","image","facebook_url","reddit_url","telegram_url","slack_url","other_url_1","other_url_2","twitter_handle","has_trading_incentive","centralized","public_notice","alert_notice","trust_score","trust_score_rank","coins","pairs","trade_volume_24h_btc","tickers","status_updates"],"type":"object"},"Response860C3Ae68Ea5_ExchangesList":{"items":{"properties":{"id":{"description":"Exchange ID","type":"string"},"name":{"description":"Exchange name","type":"string"}},"required":["id","name"],"type":"object"},"type":"array"},"Response860C3Ae68Ea5_PingServer":{"properties":{"gecko_says":{"description":"API server status message","type":"string"}},"required":["gecko_says"],"type":"object"},"Response860C3Ae68Ea5_SimplePrice":{"additionalProperties":{"properties":{"last_updated_at":{"description":"Last updated timestamp in UNIX seconds","type":"number"},"usd":{"description":"Price in the target currency","type":"number"},"usd_24h_change":{"description":"24-hour price change percentage in the target currency","type":"number"},"usd_24h_vol":{"description":"24-hour trading volume in the target currency","type":"number"},"usd_market_cap":{"description":"Market capitalization in the target currency","type":"number"}},"type":"object"},"type":"object"},"Response860C3Ae68Ea5_SupportedCurrencies":{"items":{"type":"string"},"type":"array"},"Response860C3Ae68Ea5_TrendingSearch":{"properties":{"categories":{"items":{"properties":{"coins_count":{"description":"Number of coins in the category","type":"string"},"data":{"properties":{"market_cap":{"description":"Category market cap","type":"number"},"market_cap_btc":{"description":"Category market cap in BTC","type":"number"},"market_cap_change_percentage_24h":{"additionalProperties":{"type":"number"},"description":"Category market cap change percentage in 24 hours by currency","type":"object"},"sparkline":{"description":"Category sparkline image URL","type":"string"},"total_volume":{"description":"Category total volume","type":"number"},"total_volume_btc":{"description":"Category total volume in BTC","type":"number"}},"required":["market_cap","market_cap_btc","total_volume","total_volume_btc","market_cap_change_percentage_24h","sparkline"],"type":"object"},"id":{"description":"Category ID","type":"integer"},"market_cap_1h_change":{"description":"Category market cap 1 hour change","type":"number"},"name":{"description":"Category name","type":"string"},"slug":{"description":"Category web slug","type":"string"},"top_3_coins_images":{"description":"Top 3 coins image URLs in the category","items":{"type":"string"},"type":"array"}},"required":["id","name","top_3_coins_images","market_cap_1h_change","slug","coins_count","data"],"type":"object"},"type":"array"},"coins":{"items":{"properties":{"item":{"properties":{"coin_id":{"description":"Coin internal ID","type":"integer"},"data":{"properties":{"content":{"properties":{"description":{"type":"string"},"title":{"type":"string"}},"type":["object","null"]},"market_cap":{"description":"Coin market cap in USD","type":"string"},"market_cap_btc":{"description":"Coin market cap in BTC","type":"string"},"price":{"description":"Coin price in USD","type":"number"},"price_btc":{"description":"Coin price in BTC","type":"string"},"price_change_percentage_24h":{"additionalProperties":{"type":"number"},"description":"Coin price change percentage in 24 hours by currency","type":"object"},"sparkline":{"description":"Coin sparkline image URL","type":"string"},"total_volume":{"description":"Coin total volume in USD","type":"string"},"total_volume_btc":{"description":"Coin total volume in BTC","type":"string"}},"required":["price","price_btc","price_change_percentage_24h","market_cap","market_cap_btc","total_volume","total_volume_btc","sparkline","content"],"type":"object"},"id":{"description":"Coin ID","type":"string"},"large":{"description":"Coin large image URL","type":"string"},"market_cap_rank":{"description":"Coin market cap rank","type":"integer"},"name":{"description":"Coin name","type":"string"},"price_btc":{"description":"Coin price in BTC","type":"number"},"score":{"description":"Coin trending rank (0-based)","type":"integer"},"slug":{"description":"Coin web slug","type":"string"},"small":{"description":"Coin small image URL","type":"string"},"symbol":{"description":"Coin symbol","type":"string"},"thumb":{"description":"Coin thumb image URL","type":"string"}},"required":["id","coin_id","name","symbol","market_cap_rank","thumb","small","large","slug","price_btc","score","data"],"type":"object"}},"required":["item"],"type":"object"},"type":"array"},"nfts":{"items":{"properties":{"data":{"properties":{"content":{"properties":{"description":{"type":"string"},"title":{"type":"string"}},"type":["object","null"]},"floor_price":{"description":"NFT collection floor price","type":"string"},"floor_price_in_usd_24h_percentage_change":{"description":"NFT collection floor price in USD 24 hours percentage change","type":"string"},"h24_average_sale_price":{"description":"NFT collection 24 hours average sale price","type":"string"},"h24_volume":{"description":"NFT collection volume in 24 hours","type":"string"},"sparkline":{"description":"NFT collection sparkline image URL","type":"string"}},"required":["floor_price","floor_price_in_usd_24h_percentage_change","h24_volume","h24_average_sale_price","sparkline","content"],"type":"object"},"floor_price_24h_percentage_change":{"description":"NFT collection floor price 24 hours percentage change","type":"number"},"floor_price_in_native_currency":{"description":"NFT collection floor price in native currency","type":"number"},"id":{"description":"NFT collection ID","type":"string"},"name":{"description":"NFT collection name","type":"string"},"native_currency_symbol":{"description":"NFT collection native currency symbol","type":"string"},"nft_contract_id":{"description":"NFT contract internal ID","type":"integer"},"symbol":{"description":"NFT collection symbol","type":"string"},"thumb":{"description":"NFT collection thumb image URL","type":"string"}},"required":["id","name","symbol","thumb","nft_contract_id","native_currency_symbol","floor_price_in_native_currency","floor_price_24h_percentage_change","data"],"type":"object"},"type":"array"}},"required":["coins","nfts","categories"],"type":"object"},"Response8689C55A3B97_Category":{"properties":{"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["string","null"]},"id":{"type":"string"},"label":{"type":["string","null"]},"parentCategory":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"slug":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_Chat":{"properties":{"channelId":{"type":["string","null"]},"channelImage":{"type":["string","null"]},"channelName":{"type":["string","null"]},"endTime":{"format":"date-time","type":["string","null"]},"id":{"type":"string"},"live":{"type":["boolean","null"]},"startTime":{"format":"date-time","type":["string","null"]}},"type":"object"},"Response8689C55A3B97_Collection":{"properties":{"active":{"type":["boolean","null"]},"archived":{"type":["boolean","null"]},"closed":{"type":["boolean","null"]},"collectionType":{"type":["string","null"]},"commentsEnabled":{"type":["boolean","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["string","null"]},"description":{"type":["string","null"]},"featured":{"type":["boolean","null"]},"headerImage":{"type":["string","null"]},"headerImageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"icon":{"type":["string","null"]},"iconOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"id":{"type":"string"},"image":{"type":["string","null"]},"imageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"isTemplate":{"type":["boolean","null"]},"layout":{"type":["string","null"]},"new":{"type":["boolean","null"]},"publishedAt":{"type":["string","null"]},"restricted":{"type":["boolean","null"]},"slug":{"type":["string","null"]},"subtitle":{"type":["string","null"]},"tags":{"type":["string","null"]},"templateVariables":{"type":["string","null"]},"ticker":{"type":["string","null"]},"title":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_Comment":{"properties":{"body":{"type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"id":{"type":"string"},"parentCommentID":{"type":["string","null"]},"parentEntityID":{"type":["integer","null"]},"parentEntityType":{"type":["string","null"]},"profile":{"$ref":"#/components/schemas/Response8689C55A3B97_CommentProfile"},"reactionCount":{"type":["integer","null"]},"reactions":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Reaction"},"type":"array"},"replyAddress":{"type":["string","null"]},"reportCount":{"type":["integer","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"userAddress":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_CommentPosition":{"properties":{"positionSize":{"type":["string","null"]},"tokenId":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_CommentProfile":{"properties":{"baseAddress":{"type":["string","null"]},"bio":{"type":["string","null"]},"displayUsernamePublic":{"type":["boolean","null"]},"isCreator":{"type":["boolean","null"]},"isMod":{"type":["boolean","null"]},"name":{"type":["string","null"]},"positions":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_CommentPosition"},"type":"array"},"profileImage":{"type":["string","null"]},"profileImageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"proxyWallet":{"type":["string","null"]},"pseudonym":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_Event":{"properties":{"active":{"type":["boolean","null"]},"archived":{"type":["boolean","null"]},"automaticallyActive":{"type":["boolean","null"]},"automaticallyResolved":{"type":["boolean","null"]},"cantEstimate":{"type":["boolean","null"]},"carouselMap":{"type":["string","null"]},"categories":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Category"},"type":"array"},"category":{"type":["string","null"]},"chats":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Chat"},"type":"array"},"closed":{"type":["boolean","null"]},"closedTime":{"format":"date-time","type":["string","null"]},"collections":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Collection"},"type":"array"},"commentCount":{"type":["integer","null"]},"commentsEnabled":{"type":["boolean","null"]},"competitive":{"type":["number","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["string","null"]},"creationDate":{"format":"date-time","type":["string","null"]},"cyom":{"type":["boolean","null"]},"deploying":{"type":["boolean","null"]},"deployingTimestamp":{"format":"date-time","type":["string","null"]},"description":{"type":["string","null"]},"disqusThread":{"type":["string","null"]},"elapsed":{"type":["string","null"]},"enableNegRisk":{"type":["boolean","null"]},"enableOrderBook":{"type":["boolean","null"]},"endDate":{"format":"date-time","type":["string","null"]},"ended":{"type":["boolean","null"]},"estimateValue":{"type":["boolean","null"]},"estimatedValue":{"type":["string","null"]},"eventCreators":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_EventCreator"},"type":"array"},"eventDate":{"type":["string","null"]},"eventWeek":{"type":["integer","null"]},"featured":{"type":["boolean","null"]},"featuredImage":{"type":["string","null"]},"featuredImageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"featuredOrder":{"type":["integer","null"]},"finishedTimestamp":{"format":"date-time","type":["string","null"]},"gameStatus":{"type":["string","null"]},"gmpChartMode":{"type":["string","null"]},"icon":{"type":["string","null"]},"iconOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"id":{"type":"string"},"image":{"type":["string","null"]},"imageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"isTemplate":{"type":["boolean","null"]},"liquidity":{"type":["number","null"]},"liquidityClob":{"type":["number","null"]},"live":{"type":["boolean","null"]},"markets":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Market"},"type":"array"},"negRisk":{"type":["boolean","null"]},"negRiskFeeBips":{"type":["integer","null"]},"negRiskMarketID":{"type":["string","null"]},"new":{"type":["boolean","null"]},"openInterest":{"type":["number","null"]},"parentEvent":{"type":["string","null"]},"pendingDeployment":{"type":["boolean","null"]},"period":{"type":["string","null"]},"published_at":{"type":["string","null"]},"resolutionSource":{"type":["string","null"]},"restricted":{"type":["boolean","null"]},"scheduledDeploymentTimestamp":{"format":"date-time","type":["string","null"]},"score":{"type":["string","null"]},"series":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Series"},"type":"array"},"seriesSlug":{"type":["string","null"]},"showAllOutcomes":{"type":["boolean","null"]},"showMarketImages":{"type":["boolean","null"]},"slug":{"type":["string","null"]},"sortBy":{"type":["string","null"]},"spreadsMainLine":{"type":["number","null"]},"startDate":{"format":"date-time","type":["string","null"]},"startTime":{"format":"date-time","type":["string","null"]},"subEvents":{"items":{"type":"string"},"type":["array","null"]},"subcategory":{"type":["string","null"]},"subtitle":{"type":["string","null"]},"tags":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Tag"},"type":"array"},"templateVariables":{"type":["string","null"]},"templates":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Template"},"type":"array"},"ticker":{"type":["string","null"]},"title":{"type":["string","null"]},"totalsMainLine":{"type":["number","null"]},"tweetCount":{"type":["integer","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["string","null"]},"volume":{"type":["number","null"]},"volume1mo":{"type":["number","null"]},"volume1wk":{"type":["number","null"]},"volume1yr":{"type":["number","null"]},"volume24hr":{"type":["number","null"]}},"type":"object"},"Response8689C55A3B97_EventCreator":{"properties":{"createdAt":{"format":"date-time","type":["string","null"]},"creatorHandle":{"type":["string","null"]},"creatorImage":{"type":["string","null"]},"creatorName":{"type":["string","null"]},"creatorUrl":{"type":["string","null"]},"id":{"type":"string"},"updatedAt":{"format":"date-time","type":["string","null"]}},"type":"object"},"Response8689C55A3B97_FeeSchedule":{"properties":{"exponent":{"type":["number","null"]},"rate":{"type":["number","null"]},"rebateRate":{"type":["number","null"]},"takerOnly":{"type":["boolean","null"]}},"type":"object"},"Response8689C55A3B97_ImageOptimization":{"properties":{"field":{"type":["string","null"]},"id":{"type":"string"},"imageOptimizedComplete":{"type":["boolean","null"]},"imageOptimizedLastUpdated":{"type":["string","null"]},"imageSizeKbOptimized":{"type":["number","null"]},"imageSizeKbSource":{"type":["number","null"]},"imageUrlOptimized":{"type":["string","null"]},"imageUrlSource":{"type":["string","null"]},"relID":{"type":["integer","null"]},"relname":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_KeysetEventsResponse":{"properties":{"events":{"description":"Array of Event objects. Empty array if none found.","items":{"$ref":"#/components/schemas/Response8689C55A3B97_Event"},"type":"array"},"next_cursor":{"description":"Opaque cursor token for fetching the next page. Present only when the number of returned events equals the effective limit. Omitted on the last page.\n","type":"string"}},"type":"object"},"Response8689C55A3B97_KeysetMarketsResponse":{"properties":{"markets":{"description":"Array of Market objects. Empty array if none found.","items":{"$ref":"#/components/schemas/Response8689C55A3B97_Market"},"type":"array"},"next_cursor":{"description":"Opaque cursor token for fetching the next page. Present only when the number of returned markets equals the effective limit. Omitted on the last page.\n","type":"string"}},"type":"object"},"Response8689C55A3B97_Market":{"properties":{"acceptingOrders":{"type":["boolean","null"]},"acceptingOrdersTimestamp":{"format":"date-time","type":["string","null"]},"active":{"type":["boolean","null"]},"archived":{"type":["boolean","null"]},"automaticallyActive":{"type":["boolean","null"]},"automaticallyResolved":{"type":["boolean","null"]},"bestAsk":{"type":["number","null"]},"bestBid":{"type":["number","null"]},"categories":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Category"},"type":"array"},"category":{"type":["string","null"]},"chartColor":{"type":["string","null"]},"clearBookOnStart":{"type":["boolean","null"]},"clobTokenIds":{"type":["string","null"]},"closed":{"type":["boolean","null"]},"closedTime":{"type":["string","null"]},"commentsEnabled":{"type":["boolean","null"]},"competitive":{"type":["number","null"]},"conditionId":{"type":"string"},"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["integer","null"]},"creator":{"type":["string","null"]},"curationOrder":{"type":["integer","null"]},"customLiveness":{"type":["integer","null"]},"denominationToken":{"type":["string","null"]},"deploying":{"type":["boolean","null"]},"deployingTimestamp":{"format":"date-time","type":["string","null"]},"description":{"type":["string","null"]},"disqusThread":{"type":["string","null"]},"enableOrderBook":{"type":["boolean","null"]},"endDate":{"format":"date-time","type":["string","null"]},"endDateIso":{"type":["string","null"]},"eventStartTime":{"format":"date-time","type":["string","null"]},"events":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Event"},"type":"array"},"featured":{"type":["boolean","null"]},"fee":{"type":["string","null"]},"feeSchedule":{"$ref":"#/components/schemas/Response8689C55A3B97_FeeSchedule"},"feesEnabled":{"type":["boolean","null"]},"formatType":{"type":["string","null"]},"funded":{"type":["boolean","null"]},"fundedTimestamp":{"format":"date-time","type":["string","null"]},"gameId":{"type":["string","null"]},"gameStartTime":{"type":["string","null"]},"groupItemRange":{"type":["string","null"]},"groupItemThreshold":{"type":["string","null"]},"groupItemTitle":{"type":["string","null"]},"hasReviewedDates":{"type":["boolean","null"]},"icon":{"type":["string","null"]},"iconOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"id":{"type":"string"},"image":{"type":["string","null"]},"imageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"lastTradePrice":{"type":["number","null"]},"line":{"type":["number","null"]},"liquidity":{"type":["string","null"]},"liquidityClob":{"type":["number","null"]},"liquidityNum":{"type":["number","null"]},"lowerBound":{"type":["string","null"]},"lowerBoundDate":{"type":["string","null"]},"mailchimpTag":{"type":["string","null"]},"makerBaseFee":{"type":["integer","null"]},"manualActivation":{"type":["boolean","null"]},"marketGroup":{"type":["integer","null"]},"marketType":{"type":["string","null"]},"negRiskOther":{"type":["boolean","null"]},"new":{"type":["boolean","null"]},"notificationsEnabled":{"type":["boolean","null"]},"oneDayPriceChange":{"type":["number","null"]},"oneHourPriceChange":{"type":["number","null"]},"oneMonthPriceChange":{"type":["number","null"]},"oneWeekPriceChange":{"type":["number","null"]},"oneYearPriceChange":{"type":["number","null"]},"orderMinSize":{"type":["number","null"]},"orderPriceMinTickSize":{"type":["number","null"]},"outcomePrices":{"type":["string","null"]},"outcomes":{"type":["string","null"]},"pastSlugs":{"type":["string","null"]},"pendingDeployment":{"type":["boolean","null"]},"positionIds":{"items":{"type":"string"},"type":["array","null"]},"question":{"type":["string","null"]},"questionID":{"type":["string","null"]},"ready":{"type":["boolean","null"]},"readyForCron":{"type":["boolean","null"]},"readyTimestamp":{"format":"date-time","type":["string","null"]},"resolutionSource":{"type":["string","null"]},"resolvedBy":{"type":["string","null"]},"restricted":{"type":["boolean","null"]},"rewardsMaxSpread":{"type":["number","null"]},"rewardsMinSize":{"type":["number","null"]},"rfqEnabled":{"type":["boolean","null"]},"scheduledDeploymentTimestamp":{"format":"date-time","type":["string","null"]},"score":{"type":["integer","null"]},"secondsDelay":{"type":["integer","null"]},"seriesColor":{"type":["string","null"]},"shortOutcomes":{"type":["string","null"]},"showGmpOutcome":{"type":["boolean","null"]},"showGmpSeries":{"type":["boolean","null"]},"slug":{"type":["string","null"]},"sponsorImage":{"type":["string","null"]},"sponsorName":{"type":["string","null"]},"sportsMarketType":{"type":["string","null"]},"spread":{"type":["number","null"]},"startDate":{"format":"date-time","type":["string","null"]},"startDateIso":{"type":["string","null"]},"tags":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Tag"},"type":"array"},"takerBaseFee":{"type":["integer","null"]},"teamAID":{"type":["string","null"]},"teamBID":{"type":["string","null"]},"twitterCardImage":{"type":["string","null"]},"umaBond":{"type":["string","null"]},"umaEndDate":{"type":["string","null"]},"umaEndDateIso":{"type":["string","null"]},"umaResolutionStatus":{"type":["string","null"]},"umaResolutionStatuses":{"type":["string","null"]},"umaReward":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["integer","null"]},"upperBound":{"type":["string","null"]},"upperBoundDate":{"type":["string","null"]},"version":{"type":["string","null"]},"volume":{"type":["string","null"]},"volume1mo":{"type":["number","null"]},"volume1moClob":{"type":["number","null"]},"volume1wk":{"type":["number","null"]},"volume1wkClob":{"type":["number","null"]},"volume1yr":{"type":["number","null"]},"volume1yrClob":{"type":["number","null"]},"volume24hr":{"type":["number","null"]},"volume24hrClob":{"type":["number","null"]},"volumeClob":{"type":["number","null"]},"volumeNum":{"type":["number","null"]},"wideFormat":{"type":["boolean","null"]},"xAxisValue":{"type":["string","null"]},"yAxisValue":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_Pagination":{"properties":{"hasMore":{"type":"boolean"},"totalResults":{"type":"integer"}},"type":"object"},"Response8689C55A3B97_Profile":{"properties":{"bio":{"type":["string","null"]},"certReqDate":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["integer","null"]},"displayUsernamePublic":{"type":["boolean","null"]},"id":{"type":"string"},"isCertReq":{"type":["boolean","null"]},"isCloseOnly":{"type":["boolean","null"]},"name":{"type":["string","null"]},"profileImage":{"type":["string","null"]},"profileImageOptimized":{"$ref":"#/components/schemas/Response8689C55A3B97_ImageOptimization"},"proxyWallet":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"referral":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["integer","null"]},"user":{"type":["integer","null"]},"utmCampaign":{"type":["string","null"]},"utmContent":{"type":["string","null"]},"utmMedium":{"type":["string","null"]},"utmSource":{"type":["string","null"]},"utmTerm":{"type":["string","null"]},"walletActivated":{"type":["boolean","null"]}},"type":"object"},"Response8689C55A3B97_PublicProfileResponse":{"properties":{"bio":{"description":"Profile bio","type":["string","null"]},"createdAt":{"description":"ISO 8601 timestamp of when the profile was created","format":"date-time","type":["string","null"]},"displayUsernamePublic":{"description":"Whether the username is displayed publicly","type":["boolean","null"]},"name":{"description":"User-chosen display name","type":["string","null"]},"profileImage":{"description":"URL to the profile image","format":"uri","type":["string","null"]},"proxyWallet":{"description":"The proxy wallet address","type":["string","null"]},"pseudonym":{"description":"Auto-generated pseudonym","type":["string","null"]},"users":{"description":"Array of associated user objects","items":{"$ref":"#/components/schemas/Response8689C55A3B97_PublicProfileUser"},"type":["array","null"]},"verifiedBadge":{"description":"Whether the profile has a verified badge","type":["boolean","null"]},"xUsername":{"description":"X (Twitter) username","type":["string","null"]}},"type":"object"},"Response8689C55A3B97_PublicProfileUser":{"description":"User object associated with a public profile","properties":{"creator":{"description":"Whether the user is a creator","type":"boolean"},"id":{"description":"User ID","type":"string"},"mod":{"description":"Whether the user is a moderator","type":"boolean"}},"type":"object"},"Response8689C55A3B97_Reaction":{"properties":{"commentID":{"type":["integer","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"profile":{"$ref":"#/components/schemas/Response8689C55A3B97_CommentProfile"},"reactionType":{"type":["string","null"]},"userAddress":{"type":["string","null"]}},"type":"object"},"Response8689C55A3B97_RelatedTag":{"properties":{"id":{"type":"string"},"rank":{"type":["integer","null"]},"relatedTagID":{"type":["integer","null"]},"tagID":{"type":["integer","null"]}},"type":"object"},"Response8689C55A3B97_Search":{"properties":{"events":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Event"},"type":["array","null"]},"pagination":{"$ref":"#/components/schemas/Response8689C55A3B97_Pagination"},"profiles":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Profile"},"type":["array","null"]},"tags":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_SearchTag"},"type":["array","null"]}},"type":"object"},"Response8689C55A3B97_SearchTag":{"properties":{"event_count":{"type":"integer"},"id":{"type":"string"},"label":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"Response8689C55A3B97_Series":{"properties":{"active":{"type":["boolean","null"]},"archived":{"type":["boolean","null"]},"categories":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Category"},"type":"array"},"cgAssetName":{"type":["string","null"]},"chats":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Chat"},"type":"array"},"closed":{"type":["boolean","null"]},"collections":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Collection"},"type":"array"},"commentCount":{"type":["integer","null"]},"commentsEnabled":{"type":["boolean","null"]},"competitive":{"type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["string","null"]},"description":{"type":["string","null"]},"events":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Event"},"type":"array"},"featured":{"type":["boolean","null"]},"icon":{"type":["string","null"]},"id":{"type":"string"},"image":{"type":["string","null"]},"isTemplate":{"type":["boolean","null"]},"layout":{"type":["string","null"]},"liquidity":{"type":["number","null"]},"new":{"type":["boolean","null"]},"publishedAt":{"type":["string","null"]},"pythTokenID":{"type":["string","null"]},"recurrence":{"type":["string","null"]},"restricted":{"type":["boolean","null"]},"score":{"type":["integer","null"]},"seriesType":{"type":["string","null"]},"slug":{"type":["string","null"]},"startDate":{"format":"date-time","type":["string","null"]},"subtitle":{"type":["string","null"]},"tags":{"items":{"$ref":"#/components/schemas/Response8689C55A3B97_Tag"},"type":"array"},"templateVariables":{"type":["boolean","null"]},"ticker":{"type":["string","null"]},"title":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["string","null"]},"volume":{"type":["number","null"]},"volume24hr":{"type":["number","null"]}},"type":"object"},"Response8689C55A3B97_SportsMarketTypesResponse":{"properties":{"marketTypes":{"description":"List of all valid sports market types","items":{"type":"string"},"type":"array"}},"type":"object"},"Response8689C55A3B97_SportsMetadata":{"properties":{"image":{"description":"URL to the sport's logo or image asset","format":"uri","type":"string"},"ordering":{"description":"Preferred ordering for sport display, typically \"home\" or \"away\"","type":"string"},"resolution":{"description":"URL to the official resolution source for the sport (e.g., league website)","format":"uri","type":"string"},"series":{"description":"Series identifier linking the sport to a specific tournament or season series","type":"string"},"sport":{"description":"The sport identifier or abbreviation","type":"string"},"tags":{"description":"Comma-separated list of tag IDs associated with the sport for categorization and filtering","type":"string"}},"type":"object"},"Response8689C55A3B97_Tag":{"properties":{"createdAt":{"format":"date-time","type":["string","null"]},"createdBy":{"type":["integer","null"]},"forceHide":{"type":["boolean","null"]},"forceShow":{"type":["boolean","null"]},"id":{"type":"string"},"isCarousel":{"type":["boolean","null"]},"label":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"slug":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]},"updatedBy":{"type":["integer","null"]}},"type":"object"},"Response8689C55A3B97_Team":{"properties":{"abbreviation":{"type":["string","null"]},"alias":{"type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"id":{"type":"integer"},"league":{"type":["string","null"]},"logo":{"type":["string","null"]},"name":{"type":["string","null"]},"record":{"type":["string","null"]},"updatedAt":{"format":"date-time","type":["string","null"]}},"type":"object"},"Response8689C55A3B97_Template":{"properties":{"description":{"type":["string","null"]},"eventImage":{"type":["string","null"]},"eventSlug":{"type":["string","null"]},"eventTitle":{"type":["string","null"]},"id":{"type":"string"},"marketTitle":{"type":["string","null"]},"negRisk":{"type":["boolean","null"]},"outcomes":{"type":["string","null"]},"resolutionSource":{"type":["string","null"]},"seriesSlug":{"type":["string","null"]},"showMarketImages":{"type":["boolean","null"]},"sortBy":{"type":["string","null"]}},"type":"object"},"Response876D22944B7A_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response87Ff1885565E_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response8D25370A403A_CommunityInfo":{"properties":{"admin":{"$ref":"#/components/schemas/Response8D25370A403A_User"},"banner_url":{"type":["string","null"]},"created_at":{"type":["string","null"]},"creator":{"$ref":"#/components/schemas/Response8D25370A403A_User"},"description":{"type":["string","null"]},"id":{"type":["string","null"]},"invites_policy":{"type":["string","null"]},"is_nsfw":{"type":"boolean"},"is_pinned":{"type":"boolean"},"join_policy":{"type":["string","null"]},"member_count":{"type":"integer"},"members_preview":{"items":{"type":"object"},"type":"array"},"moderator_count":{"type":"integer"},"name":{"type":["string","null"]},"primary_topic":{"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]}},"type":"object"},"question":{"type":["string","null"]},"role":{"type":["string","null"]},"rules":{"items":{"properties":{"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"},"search_tags":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Response8D25370A403A_CommunityInfoResponse":{"properties":{"community_info":{"$ref":"#/components/schemas/Response8D25370A403A_CommunityInfo"},"msg":{"type":"string"},"status":{"enum":["success","error"],"type":"string"}},"type":"object"},"Response8D25370A403A_Tweet":{"properties":{"author":{"$ref":"#/components/schemas/Response8D25370A403A_User"},"bookmarkCount":{"type":"integer"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"displayTextRange":{"items":{"type":"integer"},"type":"array"},"entities":{"properties":{"hashtags":{"items":{"properties":{"indices":{"items":{"type":"integer"},"type":"array"},"text":{"type":"string"}},"type":"object"},"type":"array"},"urls":{"items":{"properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"indices":{"items":{"type":"integer"},"type":"array"},"url":{"type":"string"}},"type":"object"},"type":"array"},"user_mentions":{"items":{"properties":{"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"id":{"type":"string"},"inReplyToId":{"type":"string"},"inReplyToUserId":{"type":"string"},"inReplyToUsername":{"type":"string"},"isLimitedReply":{"type":"boolean"},"isReply":{"type":"boolean"},"lang":{"type":"string"},"likeCount":{"type":"integer"},"quoteCount":{"type":"integer"},"quoted_tweet":{"type":"string"},"replyCount":{"type":"integer"},"retweetCount":{"type":"integer"},"retweeted_tweet":{"type":"string"},"source":{"type":"string"},"text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"viewCount":{"type":"integer"}},"type":"object"},"Response8D25370A403A_User":{"properties":{"automatedBy":{"type":"string"},"canDm":{"type":"boolean"},"coverPicture":{"type":"string"},"createdAt":{"type":"string"},"description":{"type":"string"},"favouritesCount":{"type":"integer"},"followers":{"type":"integer"},"following":{"type":"integer"},"hasCustomTimelines":{"type":"boolean"},"id":{"type":"string"},"isAutomated":{"type":"boolean"},"isBlueVerified":{"type":"boolean"},"isTranslator":{"type":"boolean"},"location":{"type":"string"},"mediaCount":{"type":"integer"},"message":{"type":"string"},"name":{"type":"string"},"pinnedTweetIds":{"items":{"type":"string"},"type":"array"},"possiblySensitive":{"type":"boolean"},"profilePicture":{"type":"string"},"profile_bio":{"properties":{"description":{"type":"string"},"entities":{"properties":{"description":{"properties":{"urls":{"items":{"properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"indices":{"items":{"type":"integer"},"type":"array"},"url":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"url":{"properties":{"urls":{"items":{"properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"indices":{"items":{"type":"integer"},"type":"array"},"url":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}},"type":"object"}},"type":"object"},"statusesCount":{"type":"integer"},"type":{"type":"string"},"unavailable":{"type":"boolean"},"unavailableReason":{"type":"string"},"url":{"type":"string"},"userName":{"type":"string"},"verifiedType":{"type":"string"},"withheldInCountries":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Response8Da310D1D213_ExplainSearchResponse":{"description":"JSON explanation response returned when response_mode is NON_STREAMING.","properties":{"message":{"description":"Generated explanation text.","type":"string"}},"required":["message"],"type":"object"},"Response8Da310D1D213_ScholarResult":{"properties":{"authors":{"description":"List of authors","items":{"type":"string"},"type":"array"},"journal":{"description":"Journal or conference name","type":"string"},"link":{"description":"URL to access the full paper","format":"uri","type":"string"},"number_of_citations":{"description":"Number of citations the paper has received","minimum":0,"type":"integer"},"snippet":{"description":"Brief summary or abstract of the paper","type":"string"},"title":{"description":"Title of the academic paper","type":"string"},"year":{"description":"Publication year","maximum":2030,"minimum":1900,"type":"integer"}},"required":["title","link","snippet","authors","number_of_citations"],"type":"object"},"Response8Da310D1D213_ScholarSearchResponse":{"properties":{"id":{"description":"Unique identifier for the search request","type":"string"},"results":{"description":"List of academic paper results","items":{"$ref":"#/components/schemas/Response8Da310D1D213_ScholarResult"},"type":"array"}},"required":["id","results"],"type":"object"},"Response8Da310D1D213_SmartResult":{"properties":{"authors":{"description":"List of authors (for academic content)","items":{"type":"string"},"type":"array"},"link":{"description":"URL to access the content","format":"uri","type":"string"},"number_of_citations":{"description":"Number of citations (for academic content)","minimum":0,"type":"integer"},"relevance_score":{"description":"Relevance score of the result","maximum":1,"minimum":0,"type":"number"},"snippet":{"description":"Brief summary or abstract","type":"string"},"title":{"description":"Title of the result","type":"string"},"type":{"description":"Type of the result","enum":["web","academic"],"type":"string"}},"required":["title","link","snippet"],"type":"object"},"Response8Da310D1D213_SmartSearchResponse":{"properties":{"id":{"description":"Unique identifier for the search request","type":"string"},"results":{"description":"List of smart search results combining web and academic content","items":{"$ref":"#/components/schemas/Response8Da310D1D213_SmartResult"},"type":"array"},"search_type":{"description":"Type of search results included","enum":["web","academic","hybrid"],"type":"string"}},"required":["id","results"],"type":"object"},"Response8Da310D1D213_WebResult":{"properties":{"display_url":{"description":"Display-friendly URL","type":"string"},"link":{"description":"URL to access the web page","format":"uri","type":"string"},"published_date":{"description":"Publication date of the web page","format":"date-time","type":"string"},"snippet":{"description":"Brief summary or preview of the web page content","type":"string"},"title":{"description":"Title of the web page","type":"string"}},"required":["title","link","snippet"],"type":"object"},"Response8Da310D1D213_WebSearchResponse":{"properties":{"id":{"description":"Unique identifier for the search request","type":"string"},"results":{"description":"List of web search results","items":{"$ref":"#/components/schemas/Response8Da310D1D213_WebResult"},"type":"array"}},"required":["id","results"],"type":"object"},"Response9A183Fe05Eb8_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"Response9Da6321Ae25F_PinterestBoardsResponse":{"additionalProperties":true,"properties":{"boards":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"credits_remaining":{"type":"integer"},"cursor":{"type":["string","null"]},"success":{"type":"boolean"}},"type":"object"},"Response9Da6321Ae25F_PinterestPinResponse":{"additionalProperties":true,"properties":{"createdAt":{"type":"string"},"credits_remaining":{"type":"integer"},"description":{"type":"string"},"entityId":{"type":"string"},"originPinner":{"additionalProperties":true,"type":["object","null"]},"pinner":{"additionalProperties":true,"type":"object"},"repinCount":{"type":"integer"},"success":{"type":"boolean"},"totalReactionCount":{"type":"integer"}},"type":"object"},"Response9Da6321Ae25F_PinterestPinsResponse":{"additionalProperties":true,"properties":{"credits_remaining":{"type":"integer"},"cursor":{"type":["string","null"]},"pins":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"success":{"type":"boolean"}},"type":"object"},"Response9E9628F8A247_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"ResponseA0396574Ebbb_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"ResponseA06878E34984_ListTweetsTimelineResponse":{"properties":{"has_next_page":{"description":"Indicates if there are more results available","type":"boolean"},"msg":{"description":"Message of the request, error message if status is error","type":"string"},"next_cursor":{"description":"Cursor for fetching the next page of results","type":"string"},"status":{"description":"Status of the request","enum":["success","error"],"example":"success","type":"string"},"tweets":{"description":"Array of tweets from the list","items":{"$ref":"#/components/schemas/ResponseA06878E34984_Tweet"},"type":"array"}},"type":"object"},"ResponseA06878E34984_Tweet":{"properties":{"author":{"$ref":"#/components/schemas/ResponseA06878E34984_TwitterUser"},"bookmarkCount":{"type":"integer"},"conversationId":{"type":"string"},"createdAt":{"description":"The date and time the tweet was created","type":"string"},"id":{"description":"The ID of the tweet","type":"string"},"inReplyToId":{"type":"string"},"inReplyToUserId":{"type":"string"},"inReplyToUsername":{"type":"string"},"isReply":{"type":"boolean"},"lang":{"description":"The language of the tweet","type":"string"},"likeCount":{"type":"integer"},"quoteCount":{"type":"integer"},"replyCount":{"type":"integer"},"retweetCount":{"type":"integer"},"source":{"description":"The source client of the tweet","type":"string"},"text":{"description":"The text of the tweet","type":"string"},"type":{"type":"string"},"url":{"description":"The URL of the tweet","type":"string"},"viewCount":{"type":"integer"}},"type":"object"},"ResponseA06878E34984_TwitterListFollowersResponse":{"properties":{"followers":{"items":{"$ref":"#/components/schemas/ResponseA06878E34984_TwitterUser"},"type":"array"},"has_next_page":{"description":"Indicates if there are more results available","type":"boolean"},"msg":{"description":"Message of the request, error message if status is error","type":"string"},"next_cursor":{"description":"Cursor for fetching the next page of results","type":"string"},"status":{"description":"Status of the request","enum":["success","error"],"type":"string"}},"type":"object"},"ResponseA06878E34984_TwitterListMembersResponse":{"properties":{"has_next_page":{"description":"Indicates if there are more results available","type":"boolean"},"members":{"items":{"$ref":"#/components/schemas/ResponseA06878E34984_TwitterUser"},"type":"array"},"msg":{"description":"Message of the request, error message if status is error","type":"string"},"next_cursor":{"description":"Cursor for fetching the next page of results","type":"string"},"status":{"description":"Status of the request","enum":["success","error"],"type":"string"}},"type":"object"},"ResponseA06878E34984_TwitterUrl":{"properties":{"display_url":{"description":"Display URL","type":"string"},"expanded_url":{"description":"Expanded URL","type":"string"},"indices":{"description":"Indices of the URL","items":{"type":"integer"},"type":"array"},"url":{"description":"URL","type":"string"}},"type":"object"},"ResponseA06878E34984_TwitterUser":{"properties":{"automatedBy":{"description":"Indicates who automated the account","type":"string"},"canDm":{"description":"Indicates if the user can be direct messaged","type":"boolean"},"coverPicture":{"description":"URL of the cover picture","type":"string"},"createdAt":{"description":"Account creation date","type":"string"},"description":{"description":"Description of the user","type":"string"},"favouritesCount":{"description":"Number of favorites","type":"integer"},"followers":{"description":"Number of followers","type":"integer"},"following":{"description":"Number of followings","type":"integer"},"hasCustomTimelines":{"description":"Indicates if the user has custom timelines","type":"boolean"},"id":{"description":"ID of the user","type":"string"},"isAutomated":{"description":"Indicates if the account is automated","type":"boolean"},"isBlueVerified":{"description":"Indicates if the user is blue verified","type":"boolean"},"isTranslator":{"description":"Indicates if the user is a translator","type":"boolean"},"location":{"description":"Location of the user","type":"string"},"mediaCount":{"description":"Number of media items","type":"integer"},"message":{"description":"Message about the account","type":"string"},"name":{"description":"Name of the user","type":"string"},"pinnedTweetIds":{"description":"List of pinned tweet IDs","items":{"type":"string"},"type":"array"},"possiblySensitive":{"description":"Indicates if the user has sensitive content","type":"boolean"},"profilePicture":{"description":"URL of the profile picture","type":"string"},"profile_bio":{"properties":{"description":{"description":"Bio description","type":"string"},"entities":{"properties":{"description":{"properties":{"urls":{"items":{"$ref":"#/components/schemas/ResponseA06878E34984_TwitterUrl"},"type":"array"}},"type":"object"},"url":{"properties":{"urls":{"items":{"$ref":"#/components/schemas/ResponseA06878E34984_TwitterUrl"},"type":"array"}},"type":"object"}},"type":"object"}},"type":"object"},"statusesCount":{"description":"Number of statuses","type":"integer"},"type":{"description":"Type of the user","type":"string"},"unavailable":{"description":"Indicates if the account is unavailable","type":"boolean"},"unavailableReason":{"description":"Reason for unavailability","type":"string"},"url":{"description":"URL of the user's profile","type":"string"},"userName":{"description":"Username of the user","type":"string"},"verifiedType":{"description":"Type of verification","type":"string"},"withheldInCountries":{"description":"List of countries where the user is withheld","items":{"type":"string"},"type":"array"}},"type":"object"},"ResponseA2A84D4Fa9Da_Category":{"properties":{"category_id":{"description":"Category identifier","type":"string"},"is_selected":{"description":"Whether this category is currently selected","type":"boolean"},"link":{"description":"Category link","type":"string"},"name":{"description":"Category name","type":"string"},"subcategories":{"description":"Nested subcategories","items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_Category"},"type":"array"}},"required":["name"],"type":"object"},"ResponseA2A84D4Fa9Da_Filter":{"properties":{"options":{"description":"Available filter options","items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_FilterOption"},"type":"array"},"type":{"description":"Filter type name","type":"string"}},"required":["options"],"type":"object"},"ResponseA2A84D4Fa9Da_FilterOption":{"properties":{"is_selected":{"description":"Whether this option is currently selected","type":"boolean"},"items":{"description":"Number of items matching this option","type":"integer"},"link":{"description":"Link to apply this filter","type":"string"},"text":{"description":"Option display text","type":"string"},"type":{"description":"Option type (for size filters)","type":"string"}},"type":"object"},"ResponseA2A84D4Fa9Da_OrganicResult":{"properties":{"authenticity":{"description":"Authenticity guarantee information","type":"string"},"bids":{"description":"Number of bids (for auctions)","type":"integer"},"brand":{"description":"Item brand","type":"string"},"buying_format":{"description":"Buying format (e.g., \"Buy It Now\", \"Auction\")","type":"string"},"condition":{"description":"Item condition","type":"string"},"deal":{"description":"Deal information","type":"string"},"discount":{"description":"Discount percentage","type":"string"},"extensions":{"description":"Additional item information","items":{"type":"string"},"type":"array"},"extracted_items_sold":{"description":"Numeric items sold value","type":"integer"},"extracted_original_price":{"description":"Numeric original price value","type":"number"},"extracted_price":{"description":"Numeric price value","type":"number"},"extracted_price_range":{"description":"Price range for items with variable pricing","properties":{"from":{"description":"Minimum price in range","type":"number"},"to":{"description":"Maximum price in range","type":"number"}},"type":"object"},"extracted_shipping":{"description":"Numeric shipping cost","type":"number"},"extracted_unit_price":{"description":"Numeric unit price value","type":"number"},"extracted_watching":{"description":"Numeric watchers value","type":"integer"},"images":{"description":"Additional item images","items":{"type":"string"},"type":"array"},"is_auction":{"description":"Whether this is an auction","type":"boolean"},"is_best_offer":{"description":"Whether best offer is available","type":"boolean"},"is_buy_it_now":{"description":"Whether buy it now is available","type":"boolean"},"is_free_return":{"description":"Whether free returns are offered","type":"boolean"},"is_in_psa_vault":{"description":"Whether item is in PSA vault","type":"boolean"},"is_price_range":{"description":"Whether price is a range","type":"boolean"},"is_sponsored":{"description":"Whether this is a sponsored result","type":"boolean"},"item_id":{"description":"eBay item identifier","type":"string"},"items_sold":{"description":"Number of items sold text","type":"string"},"link":{"description":"Link to item page","type":"string"},"original_price":{"description":"Original price before discount","type":"string"},"position":{"description":"Result position in search results","type":"integer"},"price":{"description":"Price as displayed","type":"string"},"product_id":{"description":"eBay product identifier","type":"string"},"rating":{"description":"Product rating","type":"number"},"reviews":{"description":"Number of reviews","type":"integer"},"reviews_link":{"description":"Link to reviews","type":"string"},"seller":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_Seller"},"shipping":{"description":"Shipping cost text","type":"string"},"shipping_details":{"description":"Additional shipping information","type":"string"},"stock":{"description":"Stock status","type":"string"},"subtitle":{"description":"Item subtitle","type":"string"},"tag":{"description":"Special tag (e.g., \"SPONSORED\")","type":"string"},"thumbnail":{"description":"Main item image URL","type":"string"},"time_left":{"description":"Time remaining (for auctions)","type":"string"},"title":{"description":"Item title","type":"string"},"trending":{"description":"Trending information","type":"string"},"unit_price":{"description":"Price per unit","type":"string"},"watching":{"description":"Number of watchers text","type":"string"}},"required":["position"],"type":"object"},"ResponseA2A84D4Fa9Da_Pagination":{"properties":{"current":{"description":"Current page number","type":"integer"},"next":{"description":"Link to next page","type":"string"},"other_pages":{"additionalProperties":{"type":"string"},"description":"Links to other pages (page number as key, URL as value)","type":"object"},"previous":{"description":"Link to previous page","type":"string"}},"type":"object"},"ResponseA2A84D4Fa9Da_RelatedSearch":{"properties":{"link":{"description":"Link to perform this search","type":"string"},"query":{"description":"Related search query","type":"string"}},"type":"object"},"ResponseA2A84D4Fa9Da_SearchInformation":{"properties":{"buying_format":{"description":"Selected buying format","type":"string"},"category_displayed":{"description":"Category name displayed","type":"string"},"filters_applied":{"description":"List of applied filters","items":{"type":"string"},"type":"array"},"language":{"description":"Page language code","type":"string"},"notice":{"description":"Notice eBay surfaces above the results (e.g. \"No exact matches found\" when `related_results` is returned).","type":"string"},"query_displayed":{"description":"Query as displayed on eBay","type":"string"},"shipping_to":{"description":"Shipping destination","type":"string"},"sorted_by":{"description":"Current sort order","type":"string"},"total_results":{"description":"Total number of results found","type":"integer"}},"type":"object"},"ResponseA2A84D4Fa9Da_SearchMetadata":{"properties":{"created_at":{"description":"Timestamp when the search was created","format":"date-time","type":"string"},"html_url":{"description":"URL to view HTML results","type":"string"},"id":{"description":"Unique identifier for the search request","type":"string"},"json_url":{"description":"URL to view JSON results","type":"string"},"parsing_time_taken":{"description":"Time taken to parse the results in seconds","type":"number"},"request_time_taken":{"description":"Time taken to make the request in seconds","type":"number"},"request_url":{"description":"eBay URL for this search","type":"string"},"status":{"description":"Status of the search request","type":"string"},"total_time_taken":{"description":"Total time taken for the search in seconds","type":"number"}},"required":["id","status","created_at"],"type":"object"},"ResponseA2A84D4Fa9Da_SearchParameters":{"properties":{"advanced_filters":{"description":"Advanced filters","type":"string"},"buying_format":{"description":"Buying format filter","type":"string"},"category_id":{"description":"Category ID searched","type":"integer"},"condition":{"description":"Condition filters","type":"string"},"country":{"description":"Country code","type":"string"},"delivery_country":{"description":"Delivery country","type":"string"},"distance_radius":{"description":"Distance radius","type":"number"},"ebay_domain":{"description":"eBay domain used","type":"string"},"engine":{"description":"Search engine used","type":"string"},"filters":{"description":"Applied filters","type":"string"},"include_related_results":{"description":"Whether to return \"Results matching fewer words\" items under a separate `related_results` key when no exact matches are found","type":"string"},"layout":{"description":"Layout format","type":"string"},"num":{"description":"Results per page","type":"integer"},"page":{"description":"Page number","type":"integer"},"postal_code":{"description":"Postal code","type":"string"},"price_max":{"description":"Maximum price","type":"number"},"price_min":{"description":"Minimum price","type":"number"},"product_origin_country":{"description":"Product origin country","type":"string"},"q":{"description":"Search query","type":"string"},"sort_by":{"description":"Sort order","type":"string"}},"type":"object"},"ResponseA2A84D4Fa9Da_SearchResponse":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_Category"},"type":"array"},"error":{"description":"Error message when no results are found","type":"string"},"filters":{"items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_Filter"},"type":"array"},"organic_results":{"items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_OrganicResult"},"type":"array"},"pagination":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_Pagination"},"related_results":{"description":"Returned in place of `organic_results` when eBay has no exact matches but shows \"Results matching fewer words\" items.","items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_OrganicResult"},"type":"array"},"related_searches":{"items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_RelatedSearch"},"type":"array"},"search_information":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_SearchInformation"},"search_metadata":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_SearchMetadata"},"search_parameters":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_SearchParameters"},"sections":{"items":{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_Section"},"type":"array"}},"type":"object"},"ResponseA2A84D4Fa9Da_Section":{"properties":{"has_items":{"description":"Whether results contain item listings","type":"boolean"},"is_sponsored":{"description":"Whether this section is sponsored","type":"boolean"},"results":{"description":"Section results (either category links or item listings)","items":{"oneOf":[{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_SectionResult"},{"$ref":"#/components/schemas/ResponseA2A84D4Fa9Da_OrganicResult"}]},"type":"array"},"subtitle":{"description":"Section subtitle","type":"string"},"title":{"description":"Section title","type":"string"}},"type":"object"},"ResponseA2A84D4Fa9Da_SectionResult":{"properties":{"category_id":{"description":"Category identifier","type":"string"},"link":{"description":"Result link","type":"string"},"position":{"description":"Position within section","type":"integer"},"release_date":{"description":"Release date (for certain sections)","type":"string"},"thumbnail":{"description":"Result thumbnail URL","type":"string"},"title":{"description":"Result title","type":"string"}},"type":"object"},"ResponseA2A84D4Fa9Da_Seller":{"properties":{"is_direct_from_seller":{"description":"Whether item is direct from brand/manufacturer","type":"boolean"},"is_top_rated_plus":{"description":"Whether seller is top rated plus","type":"boolean"},"name":{"description":"Seller username","type":"string"},"positive_feedback_percent":{"description":"Percentage of positive feedback","type":"number"},"reviews":{"description":"Number of seller reviews","type":"integer"},"thumbnail":{"description":"Seller logo or image URL","type":"string"}},"type":"object"},"ResponseAd3D19335Ae4_UserFollowersResponse":{"properties":{"code":{"type":"integer"},"followers":{"items":{"additionalProperties":true,"description":"Follower user object returned by TwitterAPI.io.","type":"object"},"type":"array"},"has_next_page":{"type":"boolean"},"msg":{"type":"string"},"next_cursor":{"type":["string","null"]},"status":{"enum":["success","error"],"type":"string"}},"type":"object"},"ResponseAd3D19335Ae4_UserInfoResponse":{"properties":{"data":{"additionalProperties":true,"description":"User profile object returned by TwitterAPI.io.","type":"object"},"msg":{"type":"string"},"status":{"enum":["success","error"],"type":"string"}},"type":"object"},"ResponseAd3D19335Ae4_UserProfileAboutResponse":{"properties":{"data":{"properties":{"about_profile":{"properties":{"account_based_in":{"type":"string"},"affiliate_username":{"type":"string"},"learn_more_url":{"type":"string"},"location_accurate":{"type":"boolean"},"source":{"type":"string"},"username_changes":{"properties":{"count":{"type":"string"}},"type":"object"}},"type":"object"},"affiliates_highlighted_label":{"properties":{"label":{"properties":{"badge":{"properties":{"url":{"type":"string"}},"type":"object"},"description":{"type":"string"},"url":{"properties":{"url":{"type":"string"},"urlType":{"type":"string"}},"type":"object"},"userLabelDisplayType":{"type":"string"},"userLabelType":{"type":"string"}},"type":"object"}},"type":"object"},"createdAt":{"type":"string"},"id":{"type":"string"},"identity_profile_labels_highlighted_label":{"properties":{"label":{"properties":{"badge":{"properties":{"url":{"type":"string"}},"type":"object"},"description":{"type":"string"},"url":{"properties":{"url":{"type":"string"},"urlType":{"type":"string"}},"type":"object"},"userLabelDisplayType":{"type":"string"},"userLabelType":{"type":"string"}},"type":"object"}},"type":"object"},"isBlueVerified":{"type":"boolean"},"name":{"type":"string"},"protected":{"type":"boolean"},"userName":{"type":"string"}},"type":"object"},"msg":{"type":"string"},"status":{"enum":["success","error"],"type":"string"}},"type":"object"},"ResponseAd3D19335Ae4_UserTweetsResponse":{"properties":{"code":{"description":"Provider status code returned by the AIsa wrapper.","type":"integer"},"data":{"additionalProperties":true,"properties":{"pin_tweet":{"additionalProperties":true,"type":["object","null"]},"tweets":{"items":{"additionalProperties":true,"description":"Tweet object returned by TwitterAPI.io.","type":"object"},"type":"array"}},"type":"object"},"has_next_page":{"type":"boolean"},"msg":{"type":"string"},"next_cursor":{"type":["string","null"]},"status":{"enum":["success","error"],"type":"string"}},"type":"object"},"ResponseB5Ae154C25F3_BatchUserInfoResponse":{"properties":{"msg":{"type":"string"},"status":{"enum":["success","error"],"type":"string"},"users":{"items":{"properties":{"automatedBy":{"type":"string"},"canDm":{"type":"boolean"},"coverPicture":{"type":"string"},"createdAt":{"type":"string"},"description":{"type":"string"},"favouritesCount":{"type":"integer"},"followers":{"type":"integer"},"following":{"type":"integer"},"hasCustomTimelines":{"type":"boolean"},"id":{"type":"string"},"isAutomated":{"type":"boolean"},"isBlueVerified":{"type":"boolean"},"isTranslator":{"type":"boolean"},"location":{"type":"string"},"mediaCount":{"type":"integer"},"message":{"type":"string"},"name":{"type":"string"},"pinnedTweetIds":{"items":{"type":"string"},"type":"array"},"possiblySensitive":{"type":"boolean"},"profilePicture":{"type":"string"},"statusesCount":{"type":"integer"},"type":{"type":"string"},"unavailable":{"type":"boolean"},"unavailableReason":{"type":"string"},"url":{"type":"string"},"userName":{"type":"string"},"verifiedType":{"type":"string"},"withheldInCountries":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"},"ResponseBd0Df3C14905_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"ResponseBfde03595B3D_GpsCoordinates":{"properties":{"latitude":{"description":"Latitude coordinate","type":"number"},"longitude":{"description":"Longitude coordinate","type":"number"}},"type":"object"},"ResponseBfde03595B3D_Pagination":{"properties":{"next_page_token":{"description":"Token to retrieve the next page of results","type":"string"}},"type":"object"},"ResponseBfde03595B3D_Price":{"properties":{"breakdown":{"description":"Every itemized price line: the stay subtotal, any discount lines, any tax or fee lines, and the total. The lines sum to the total, so a listing's taxes are read from here rather than from a single field, since a card can carry several tax lines. Line descriptions are localized to the airbnb_domain.","items":{"$ref":"#/components/schemas/ResponseBfde03595B3D_PriceBreakdownItem"},"type":"array"},"discount":{"description":"Discount amount display text","type":"string"},"extracted_discount":{"description":"Numeric discount value","type":"number"},"extracted_original_price":{"description":"Numeric original price value","type":"number"},"extracted_price_per_qualifier":{"description":"Numeric price per qualifier value","type":"number"},"extracted_qualifier":{"description":"Numeric qualifier value","type":"integer"},"extracted_total_price":{"description":"Numeric total price value","type":"number"},"extracted_total_with_taxes":{"description":"Numeric all-in total extracted from `total_with_taxes`","type":"number"},"original_price":{"description":"Original price before discount","type":"string"},"price_per_qualifier":{"description":"Price breakdown per qualifier","type":"string"},"qualifier":{"description":"Price qualifier text (e.g., per night, per week)","type":"string"},"total_price":{"description":"Total price display text","type":"string"},"total_with_taxes":{"description":"Formatted all-in total including taxes and fees. Exact, where `total_price` is Airbnb's rounded display figure. Present only when Airbnb provides an all-in figure, so its absence means no tax-inclusive price was available.","type":"string"}},"type":"object"},"ResponseBfde03595B3D_PriceBreakdownItem":{"properties":{"description":{"description":"Breakdown item description","type":"string"},"extracted_price":{"description":"Numeric breakdown item price. Signed, so discount lines are negative and the lines sum to the total.","type":"number"},"price":{"description":"Breakdown item price display text","type":"string"}},"type":"object"},"ResponseBfde03595B3D_Property":{"properties":{"accommodations":{"description":"Accommodation details (bedrooms, beds, bathrooms)","items":{"type":"string"},"type":"array"},"badges":{"description":"Property badges (e.g., Guest favorite, Superhost)","items":{"type":"string"},"type":"array"},"booking_link":{"description":"Direct booking URL with dates and guest parameters","type":"string"},"check_in_date":{"description":"Check-in date for this property","type":"string"},"check_out_date":{"description":"Check-out date for this property","type":"string"},"description":{"description":"Property description","type":"string"},"distance":{"description":"Distance from search location","type":"string"},"extracted_distance":{"description":"Numeric distance value","type":"number"},"gps_coordinates":{"$ref":"#/components/schemas/ResponseBfde03595B3D_GpsCoordinates"},"has_free_cancellation":{"description":"Present and true when the card shows a \"Free cancellation\" highlight. Omitted otherwise.","type":"boolean"},"id":{"description":"Unique property listing ID","type":"string"},"images":{"description":"Property image URLs","items":{"type":"string"},"type":"array"},"link":{"description":"URL to property details page","type":"string"},"position":{"description":"Position in search results","type":"integer"},"price":{"$ref":"#/components/schemas/ResponseBfde03595B3D_Price"},"rating":{"description":"Average rating score","type":"number"},"reviews":{"description":"Number of reviews","type":"integer"},"time_period":{"description":"Date range display text","type":"string"},"title":{"description":"Property title","type":"string"}},"type":"object"},"ResponseBfde03595B3D_SearchInformation":{"properties":{"adults":{"description":"Number of adult guests","type":"integer"},"check_in_date":{"description":"Check-in date from search","type":"string"},"check_out_date":{"description":"Check-out date from search","type":"string"},"children":{"description":"Number of child guests","type":"integer"},"guests":{"description":"Guest count display text","type":"string"},"infants":{"description":"Number of infant guests","type":"integer"},"pets":{"description":"Number of pets","type":"integer"},"query_displayed":{"description":"Location query as displayed by Airbnb","type":"string"},"results":{"description":"Results summary text","type":"string"},"time_period":{"description":"Time period display text","type":"string"}},"type":"object"},"ResponseBfde03595B3D_SearchMetadata":{"properties":{"created_at":{"description":"Timestamp when the search was created","format":"date-time","type":"string"},"html_url":{"description":"URL to view HTML results","type":"string"},"id":{"description":"Unique identifier for the search request","type":"string"},"json_url":{"description":"URL to view JSON results","type":"string"},"parsing_time_taken":{"description":"Time taken to parse the results in seconds","type":"number"},"request_time_taken":{"description":"Time taken to make the request in seconds","type":"number"},"request_url":{"description":"Airbnb URL for this search","type":"string"},"status":{"description":"Status of the search request","type":"string"},"total_time_taken":{"description":"Total time taken for the search in seconds","type":"number"}},"type":"object"},"ResponseBfde03595B3D_SearchParameters":{"properties":{"adults":{"description":"Number of adults","type":"integer"},"airbnb_domain":{"description":"Airbnb domain searched","type":"string"},"amenities":{"description":"Amenities filter","type":"string"},"bathrooms":{"description":"Minimum bathrooms","type":"integer"},"bedrooms":{"description":"Minimum bedrooms","type":"integer"},"beds":{"description":"Minimum beds","type":"integer"},"bounding_box":{"description":"Geographic bounding box coordinates","type":"string"},"check_in_date":{"description":"Check-in date","type":"string"},"check_out_date":{"description":"Check-out date","type":"string"},"children":{"description":"Number of children","type":"integer"},"currency":{"description":"Currency code for pricing","type":"string"},"engine":{"description":"Search engine used","type":"string"},"include_taxes":{"description":"Whether tax-inclusive pricing was requested","type":"string"},"infants":{"description":"Number of infants","type":"integer"},"next_page_token":{"description":"Pagination token","type":"string"},"pets":{"description":"Number of pets","type":"integer"},"price_max":{"description":"Maximum price filter","type":"integer"},"price_min":{"description":"Minimum price filter","type":"integer"},"property_types":{"description":"Property types filter","type":"string"},"q":{"description":"Search query location","type":"string"},"time_period":{"description":"Flexible trip length","type":"string"},"type_of_place":{"description":"Type of accommodation","type":"string"}},"type":"object"},"ResponseBfde03595B3D_SearchResponse":{"properties":{"error":{"description":"Error message when no results are found","type":"string"},"pagination":{"$ref":"#/components/schemas/ResponseBfde03595B3D_Pagination"},"properties":{"description":"List of property results","items":{"$ref":"#/components/schemas/ResponseBfde03595B3D_Property"},"type":"array"},"search_information":{"$ref":"#/components/schemas/ResponseBfde03595B3D_SearchInformation"},"search_metadata":{"$ref":"#/components/schemas/ResponseBfde03595B3D_SearchMetadata"},"search_parameters":{"$ref":"#/components/schemas/ResponseBfde03595B3D_SearchParameters"}},"type":"object"},"ResponseC6C9032778Bd_SimilarWebMeta":{"description":"SimilarWeb v5 response envelope metadata.","properties":{"last_updated":{"description":"Date of the most recent data point available upstream (YYYY-MM-DD).","example":"2026-06-30","type":"string"},"query":{"description":"Pagination/sort echo when applicable (limit, offset, asc, sort).","type":"object"},"request":{"description":"Full echo of the normalized upstream request (parameters as received).","type":"object"},"status":{"description":"Upstream status; 'success' on a successful call.","example":"success","type":"string"}},"required":["status"],"type":"object"},"ResponseCbc4F8806E32_AdvancedSearchResponse":{"properties":{"has_next_page":{"type":"boolean"},"next_cursor":{"type":"string"},"tweets":{"items":{"$ref":"#/components/schemas/ResponseCbc4F8806E32_Tweet"},"type":"array"}},"type":"object"},"ResponseCbc4F8806E32_Article":{"properties":{"author":{"$ref":"#/components/schemas/ResponseCbc4F8806E32_User"},"contents":{"items":{"properties":{"text":{"type":"string"}},"type":"object"},"type":"array"},"cover_media_img_url":{"type":"string"},"createdAt":{"type":"string"},"likeCount":{"type":"integer"},"preview_text":{"type":"string"},"quoteCount":{"type":"integer"},"replyCount":{"type":"integer"},"title":{"type":"string"},"viewCount":{"type":"integer"}},"type":"object"},"ResponseCbc4F8806E32_ArticleResponse":{"properties":{"article":{"$ref":"#/components/schemas/ResponseCbc4F8806E32_Article"},"msg":{"type":"string"},"status":{"enum":["success","failed"],"type":"string"}},"type":"object"},"ResponseCbc4F8806E32_Entities":{"properties":{"hashtags":{"items":{"properties":{"indices":{"items":{"type":"integer"},"type":"array"},"text":{"type":"string"}},"type":"object"},"type":"array"},"urls":{"items":{"properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"indices":{"items":{"type":"integer"},"type":"array"},"url":{"type":"string"}},"type":"object"},"type":"array"},"user_mentions":{"items":{"properties":{"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"ResponseCbc4F8806E32_Tweet":{"properties":{"author":{"$ref":"#/components/schemas/ResponseCbc4F8806E32_User"},"bookmarkCount":{"type":"integer"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"displayTextRange":{"items":{"type":"integer"},"type":"array"},"entities":{"$ref":"#/components/schemas/ResponseCbc4F8806E32_Entities"},"id":{"type":"string"},"inReplyToId":{"type":"string"},"inReplyToUserId":{"type":"string"},"inReplyToUsername":{"type":"string"},"isLimitedReply":{"type":"boolean"},"isReply":{"type":"boolean"},"lang":{"type":"string"},"likeCount":{"type":"integer"},"quoteCount":{"type":"integer"},"quoted_tweet":{"type":"string"},"replyCount":{"type":"integer"},"retweetCount":{"type":"integer"},"retweeted_tweet":{"type":"string"},"source":{"type":"string"},"text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"viewCount":{"type":"integer"}},"type":"object"},"ResponseCbc4F8806E32_TweetThreadContextResponse":{"properties":{"has_next_page":{"type":"boolean"},"msg":{"type":"string"},"next_cursor":{"type":"string"},"status":{"enum":["success","error"],"type":"string"},"tweets":{"items":{"$ref":"#/components/schemas/ResponseCbc4F8806E32_Tweet"},"type":"array"}},"type":"object"},"ResponseCbc4F8806E32_User":{"properties":{"automatedBy":{"type":"string"},"canDm":{"type":"boolean"},"coverPicture":{"type":"string"},"createdAt":{"type":"string"},"description":{"type":"string"},"favouritesCount":{"type":"integer"},"followers":{"type":"integer"},"following":{"type":"integer"},"hasCustomTimelines":{"type":"boolean"},"id":{"type":"string"},"isAutomated":{"type":"boolean"},"isBlueVerified":{"type":"boolean"},"isTranslator":{"type":"boolean"},"location":{"type":"string"},"mediaCount":{"type":"integer"},"message":{"type":"string"},"name":{"type":"string"},"pinnedTweetIds":{"items":{"type":"string"},"type":"array"},"possiblySensitive":{"type":"boolean"},"profilePicture":{"type":"string"},"statusesCount":{"type":"integer"},"type":{"type":"string"},"unavailable":{"type":"boolean"},"unavailableReason":{"type":"string"},"url":{"type":"string"},"userName":{"type":"string"},"verifiedType":{"type":"string"},"withheldInCountries":{"items":{"type":"string"},"type":"array"}},"type":"object"},"ResponseD09F9471A0E8_Count":{"description":"Number of items returned.","title":"Count","type":"integer"},"ResponseD09F9471A0E8_Limit":{"description":"Limit of number of items returned.","title":"Limit","type":"integer"},"ResponseD09F9471A0E8_OrganizationId":{"description":"ID of organization.","title":"OrganizationId","type":"string"},"ResponseD09F9471A0E8_PageToken":{"description":"Page token for pagination.","title":"PageToken","type":"string"},"ResponseD09F9471A0E8_apiKeys_ApiKey":{"description":"One credential of any family. `type` is `bearer` or `public_key`. A\npublic key carrying `status` is a sign-in key; one without it is a\nregistered signing key.","oneOf":[{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_BearerApiKey"},{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicKeyCredential"}],"title":"ApiKey"},"ResponseD09F9471A0E8_apiKeys_ApiKeyCreator":{"description":"The bearer API key that created the credential. Provenance only; the credential outlives it.","properties":{"api_key_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyId"}},"required":["api_key_id"],"title":"ApiKeyCreator","type":"object"},"ResponseD09F9471A0E8_apiKeys_ApiKeyId":{"description":"ID of api key.","title":"ApiKeyId","type":"string"},"ResponseD09F9471A0E8_apiKeys_ApiKeyPermissions":{"description":"Granular permissions for the API key. When ommitted all permissions are granted. Otherwise, only permissions set to true are granted.","properties":{"account_update":{"description":"Update accounts: disable or re-enable an inbox's sign-in at an app. Reading accounts\nneeds only `inbox_read`.","type":"boolean"},"api_key_create":{"description":"Create API keys.","type":"boolean"},"api_key_delete":{"description":"Delete API keys.","type":"boolean"},"api_key_read":{"description":"Read API keys.","type":"boolean"},"api_key_update":{"description":"Update API keys.","type":"boolean"},"app_connect":{"description":"Sign in to apps as an inbox: connect an app, authorize an inbox, and mint the\nsign-in keys. Omitted on a new bearer key means false, whatever else the key holds.","type":"boolean"},"app_share_owner":{"description":"Share the organization owner's name and email with apps at sign-in. One permission\nfor both values.","type":"boolean"},"calendar_event_create":{"description":"Create calendar events.","type":"boolean"},"calendar_event_delete":{"description":"Delete calendar events.","type":"boolean"},"calendar_event_read":{"description":"Read calendar events, and receive `calendar.event.*` webhook and WebSocket events.","type":"boolean"},"calendar_event_update":{"description":"Update calendar events and respond to invitations.","type":"boolean"},"calendar_read":{"description":"Read inbox calendar settings.","type":"boolean"},"calendar_update":{"description":"Update inbox calendar settings.","type":"boolean"},"domain_create":{"description":"Create domains.","type":"boolean"},"domain_delete":{"description":"Delete domains.","type":"boolean"},"domain_read":{"description":"Read domain details.","type":"boolean"},"domain_update":{"description":"Update domains.","type":"boolean"},"draft_create":{"description":"Create drafts.","type":"boolean"},"draft_delete":{"description":"Delete drafts.","type":"boolean"},"draft_read":{"description":"Read drafts.","type":"boolean"},"draft_send":{"description":"Send drafts.","type":"boolean"},"draft_update":{"description":"Update drafts.","type":"boolean"},"inbox_create":{"description":"Create new inboxes.","type":"boolean"},"inbox_delete":{"description":"Delete inboxes.","type":"boolean"},"inbox_read":{"description":"Read inbox details.","type":"boolean"},"inbox_update":{"description":"Update inbox settings.","type":"boolean"},"label_blocked_read":{"description":"Access messages labeled blocked.","type":"boolean"},"label_spam_read":{"description":"Access messages labeled spam.","type":"boolean"},"label_trash_read":{"description":"Access messages labeled trash.","type":"boolean"},"label_unauthenticated_read":{"description":"Access messages labeled unauthenticated.","type":"boolean"},"list_entry_create":{"description":"Create list entries.","type":"boolean"},"list_entry_delete":{"description":"Delete list entries.","type":"boolean"},"list_entry_read":{"description":"Read list entries.","type":"boolean"},"message_delete":{"description":"Delete messages. Also required to delete threads.","type":"boolean"},"message_read":{"description":"Read messages. Also required to read threads.","type":"boolean"},"message_reply":{"description":"Reply and reply-all when the request is signed with a registered public key. Bearer keys reply with `message_send`.","type":"boolean"},"message_send":{"description":"Send messages.","type":"boolean"},"message_update":{"description":"Update message labels. Also required to update threads.","type":"boolean"},"metrics_read":{"description":"Read metrics.","type":"boolean"},"pod_create":{"description":"Create pods.","type":"boolean"},"pod_delete":{"description":"Delete pods.","type":"boolean"},"pod_read":{"description":"Read pods.","type":"boolean"},"pod_update":{"description":"Update pods.","type":"boolean"},"webhook_create":{"description":"Create webhooks.","type":"boolean"},"webhook_delete":{"description":"Delete webhooks.","type":"boolean"},"webhook_read":{"description":"Read webhook configurations.","type":"boolean"},"webhook_update":{"description":"Update webhooks.","type":"boolean"}},"title":"ApiKeyPermissions","type":"object"},"ResponseD09F9471A0E8_apiKeys_BearerApiKey":{"description":"An API key presented as a bearer token in the `Authorization` header.","properties":{"api_key_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyId"},"created_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_CreatedAt"},"expires_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ExpiresAt"},"inbox_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_InboxScopeId"},"name":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_Name"},"permissions":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyPermissions"},"pod_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PodScopeId"},"prefix":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_Prefix"},"type":{"enum":["bearer"],"type":"string"},"updated_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_UpdatedAt"},"used_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_UsedAt"}},"required":["type","api_key_id","prefix","name","created_at","updated_at"],"title":"BearerApiKey","type":"object"},"ResponseD09F9471A0E8_apiKeys_CreateApiKeyResponse":{"properties":{"api_key":{"description":"API key.","type":"string"},"api_key_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyId"},"created_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_CreatedAt"},"expires_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ExpiresAt"},"inbox_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_InboxScopeId"},"name":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_Name"},"permissions":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyPermissions"},"pod_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PodScopeId"},"prefix":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_Prefix"}},"required":["api_key_id","api_key","prefix","name","created_at"],"title":"CreateApiKeyResponse","type":"object"},"ResponseD09F9471A0E8_apiKeys_CreateApiKeyResult":{"description":"The secret-bearing bearer key, or the registered public key without any secret.","oneOf":[{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_CreateApiKeyResponse"},{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicKeyCredential"}],"title":"CreateApiKeyResult"},"ResponseD09F9471A0E8_apiKeys_CreatedAt":{"description":"Time at which api key was created.","format":"date-time","title":"CreatedAt","type":"string"},"ResponseD09F9471A0E8_apiKeys_ExpiresAt":{"description":"Time at which api key expires. Omitted when it does not expire.","format":"date-time","title":"ExpiresAt","type":"string"},"ResponseD09F9471A0E8_apiKeys_InboxScopeId":{"description":"Inbox ID the api key is scoped to. If set, the key can only access resources within this inbox.","title":"InboxScopeId","type":"string"},"ResponseD09F9471A0E8_apiKeys_ListApiKeysResponse":{"properties":{"api_keys":{"description":"Every credential family, ordered by `created_at`. `type` restricts\nto one family.","items":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKey"},"type":"array"},"count":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_Count"},"next_page_token":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_PageToken"}},"required":["count","api_keys"],"title":"ListApiKeysResponse","type":"object"},"ResponseD09F9471A0E8_apiKeys_Name":{"description":"Name of api key.","title":"Name","type":"string"},"ResponseD09F9471A0E8_apiKeys_PodScopeId":{"description":"Pod ID the api key is scoped to. If set, the key can only access resources within this pod.","title":"PodScopeId","type":"string"},"ResponseD09F9471A0E8_apiKeys_Prefix":{"description":"Prefix of api key.","title":"Prefix","type":"string"},"ResponseD09F9471A0E8_apiKeys_PublicJwk":{"description":"A public P-256 JWK. The object accepts exactly `kty`, `crv`, `x`, and `y`.\nPrivate key material such as `d`, embedded key IDs, and all other members\nare rejected. The server also rejects coordinates that are not a point on\nP-256.","properties":{"crv":{"enum":["P-256"],"type":"string"},"kty":{"enum":["EC"],"type":"string"},"x":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicJwkCoordinate"},"y":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicJwkCoordinate"}},"required":["kty","crv","x","y"],"title":"PublicJwk","type":"object"},"ResponseD09F9471A0E8_apiKeys_PublicJwkCoordinate":{"description":"A 32-byte P-256 coordinate encoded as unpadded base64url.","maxLength":43,"minLength":43,"pattern":"^[A-Za-z0-9_-]{43}$","title":"PublicJwkCoordinate","type":"string"},"ResponseD09F9471A0E8_apiKeys_PublicKeyClientId":{"description":"Caller-chosen alias for a public key, unique within the organization and\nreusable after deletion. Accepted in place of `api_key_id` on get, update,\nand delete. Registration is idempotent on it: the same alias returns the\nexisting key, a conflicting one returns `409`. URL-safe; no slash or `@`.","title":"PublicKeyClientId","type":"string"},"ResponseD09F9471A0E8_apiKeys_PublicKeyCredential":{"description":"An AgentID sign-in credential, scoped like a bearer key; `api_key_id` is\nthe JWS `kid`. A sign-in key carries `status`, gains `public_key` once\nthe client has proved it, expires 30 days after\nactivation, and carries exactly `app_connect` and\n`app_share_owner`, snapshotted from the bearer key that created it\nand enforced from the key itself.","properties":{"api_key_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyId"},"client_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicKeyClientId"},"created_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_CreatedAt"},"created_by":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyCreator"},"expires_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ExpiresAt"},"inbox_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_InboxScopeId"},"name":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_Name"},"permissions":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_ApiKeyPermissions"},"pod_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PodScopeId"},"public_key":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicKeyMaterial"},"status":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicKeyStatus"},"type":{"enum":["public_key"],"type":"string"},"updated_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_UpdatedAt"},"used_at":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_UsedAt"}},"required":["type","api_key_id","name","permissions","created_by","created_at","updated_at"],"title":"PublicKeyCredential","type":"object"},"ResponseD09F9471A0E8_apiKeys_PublicKeyMaterial":{"description":"Registered public key material and its server-computed RFC 7638 thumbprint.","properties":{"fingerprint":{"description":"RFC 7638 SHA-256 JWK thumbprint encoded as unpadded base64url.","maxLength":43,"minLength":43,"pattern":"^[A-Za-z0-9_-]{43}$","type":"string"},"jwk":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_apiKeys_PublicJwk"}},"required":["jwk","fingerprint"],"title":"PublicKeyMaterial","type":"object"},"ResponseD09F9471A0E8_apiKeys_PublicKeyStatus":{"description":"Lifecycle of a sign-in key: `pending` until the client finishes\ncreating it on the AgentID page, `active` once it can sign in as the\ninbox. Absent on a registered key.","enum":["pending","active"],"title":"PublicKeyStatus","type":"string"},"ResponseD09F9471A0E8_apiKeys_UpdatedAt":{"description":"Time at which api key was last updated.","format":"date-time","title":"UpdatedAt","type":"string"},"ResponseD09F9471A0E8_apiKeys_UsedAt":{"description":"Time at which api key was last used.","format":"date-time","title":"UsedAt","type":"string"},"ResponseD09F9471A0E8_attachments_Attachment":{"properties":{"attachment_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentId"},"content_disposition":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentContentDisposition"},"content_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentContentType"},"filename":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentFilename"},"size":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentSize"}},"required":["attachment_id","size"],"title":"Attachment","type":"object"},"ResponseD09F9471A0E8_attachments_AttachmentContentDisposition":{"description":"Content disposition of attachment.","enum":["inline","attachment"],"title":"AttachmentContentDisposition","type":"string"},"ResponseD09F9471A0E8_attachments_AttachmentContentId":{"description":"Content ID of attachment.","title":"AttachmentContentId","type":"string"},"ResponseD09F9471A0E8_attachments_AttachmentContentType":{"description":"Content type of attachment.","title":"AttachmentContentType","type":"string"},"ResponseD09F9471A0E8_attachments_AttachmentFilename":{"description":"Filename of attachment.","title":"AttachmentFilename","type":"string"},"ResponseD09F9471A0E8_attachments_AttachmentId":{"description":"ID of attachment.","title":"AttachmentId","type":"string"},"ResponseD09F9471A0E8_attachments_AttachmentResponse":{"properties":{"attachment_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentId"},"content_disposition":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentContentDisposition"},"content_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentContentType"},"download_url":{"description":"Signed HTTPS CDN URL to download the attachment bytes. Retrieve a fresh URL when needed rather than storing it permanently.","type":"string"},"expires_at":{"description":"Time at which download_url and text_url (when present) expire. Retrieve the attachment again to obtain fresh URLs.","format":"date-time","type":"string"},"filename":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentFilename"},"size":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_attachments_AttachmentSize"},"text_url":{"description":"Signed HTTPS CDN URL to download extracted plain text, when available. Omitted when no extracted text is available. Expires at the same time as download_url.","type":"string"}},"required":["attachment_id","size","download_url","expires_at"],"title":"AttachmentResponse","type":"object"},"ResponseD09F9471A0E8_attachments_AttachmentSize":{"description":"Size of attachment in bytes.","title":"AttachmentSize","type":"integer"},"ResponseD09F9471A0E8_domains_ClientId":{"description":"Client ID of domain.","title":"ClientId","type":"string"},"ResponseD09F9471A0E8_domains_Domain":{"properties":{"client_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_domains_ClientId"},"created_at":{"description":"Time at which the domain was created.","format":"date-time","type":"string"},"domain":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_domains_DomainName"},"domain_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_domains_DomainId"},"feedback_enabled":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_domains_FeedbackEnabled"},"inbound_enabled":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_domains_InboundEnabled","description":"Absent on domains created before this field existed; those receive email."},"pod_id":{"$ref":"#/components/schemas/ResponseD09F9471A0E8_pods_PodId"},"reason":{"description":"Why the domain is not (yet) VERIFIED, when known. `dns_records_missing` / `dns_records_invalid` point at the DNS records. The `ses_*` values mean the records look right and sending-infrastructure validation has not converged: `ses_dkim_pending` / `ses_mail_from_pending` (still checking), `ses_dkim_temporary_failure` / `ses_mail_from_temporary_failure` (a transient error the infrastructure keeps retrying on its own — usually resolves without changes), `ses_dkim_failed` / `ses_mail_from_failed` (a terminal verdict; re-verify after fixing), `ses_dkim_not_started` / `ses_mail_from_not_started` (the attribute was never configured on the identity — re-verify to push it), and `ses_not_verified_for_sending`. Absent when VERIFIED.","type":"string"},"records":{"description":"A list of DNS records required to verify the domain. Includes the apex\nMX record unless `inbound_enabled` is false, and a wildcard MX record\n(`*.
If you do not specify the account stage, Apollo automatically assigns the account to a stage as determined by your team's Apollo account. To change the order of account stages, launch the Apollo product and go to Settings > Objects > Accounts. Then, access the Triggers tab and change the stage for when an account is created.
Example: `6095a710bd01d100a506d4b9`","type":"string"},"domain":{"description":"The domain name for the account.
Do not include `www.` or similar.
Example: `apollo.io` or `microsoft.com`","type":"string"},"name":{"description":"Name the account that you are creating. This should be a human-readable name.
Example: `The Irish Copywriters`","type":"string"},"owner_id":{"description":"The ID for the account owner within your team's Apollo account.
Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.
Example: `66302798d03b9601c7934ebf`","type":"string"},"phone":{"description":"The primary phone number for the account.
This can be the phone number for the corporate headquarters, a branch location, or a direct dial to the primary point of contact for the account.
Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.
Examples: `555-555-0133`; `+44 7700 900852`","type":"string"},"raw_address":{"description":"The corporate location for the account. This can include a city, US state, and country.
Apollo matches the location you provide to the most applicable pre-defined location.
Examples: `Belfield, Dublin 4, Ireland`; `Dallas, United States`","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Add information to custom fields in Apollo.
Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.
To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.
Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"account":{"additionalProperties":true,"description":"Created account","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Create an Account","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-accounts","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:3efe3b188b8fb1e0e2f9a701647b87acdbee7089e54ad5995ef638a12f826139","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a7b0c338b026"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_accounts","path":"/apis/v1/apollo/accounts"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts","x-aisa-validation":"provider"}},"/apis/v1/apollo/accounts/bulk_create":{"post":{"description":"Bulk create accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_accounts_bulk_create","requestBody":{"content":{"application/json":{"examples":{"Basic Account Creation":{"value":{"accounts":[{"domain":"acme.com","name":"Acme Corporation","phone":"+1-555-0135"},{"domain":"example.com","linkedin_url":"https://linkedin.com/company/techstart","name":"TechStart Inc"}]}},"With CRM IDs (Returns Existing Without Updating)":{"value":{"accounts":[{"name":"New Name","phone":"+1-555-0159","salesforce_id":"001pJNj9pix2idKsfj"},{"hubspot_id":"12345678","name":"Another New Name"}]}},"With Custom Fields and Labels":{"value":{"accounts":[{"account_stage_id":"507f1f77bcf86cd799439014","domain":"example.com","name":"Enterprise Client","typed_custom_fields":{"507f1f77bcf86cd799439020":"High Value","507f1f77bcf86cd799439021":"Q4 2025"}}],"append_label_names":["Enterprise","Priority"]}},"With Deduplication (Returns Existing Without Updating)":{"value":{"accounts":[{"domain":"existing-company.com","name":"New Company Name"}],"run_dedupe":true}}},"schema":{"properties":{"accounts":{"description":"Array of account attribute objects (maximum 100 accounts per request)","items":{"properties":{"account_stage_id":{"description":"Account stage/pipeline stage ID (BSON::ObjectId format)","example":"507f1f77bcf86cd799439014","type":"string"},"domain":{"description":"Company domain (e.g., 'example.com')","example":"acme.com","type":"string"},"facebook_url":{"description":"Facebook page URL","example":"https://facebook.com/acme","type":"string"},"hubspot_id":{"description":"HubSpot company ID for CRM integration","example":"12345678","type":"string"},"linkedin_url":{"description":"LinkedIn company page URL","example":"https://linkedin.com/company/acme","type":"string"},"merged_crm_ids":{"description":"Additional CRM IDs for deduplication","items":{"type":"string"},"type":"array"},"name":{"description":"Account name","example":"Acme Corporation","type":"string"},"organization_id":{"description":"Apollo organization ID","example":"507f1f77bcf86cd799439012","type":"string"},"owner_id":{"description":"Account owner user ID (BSON::ObjectId format). Defaults to current user if not provided","example":"507f1f77bcf86cd799439013","type":"string"},"parent_account_id":{"description":"Parent account ID for account hierarchy (BSON::ObjectId format)","example":"507f1f77bcf86cd799439016","type":"string"},"phone":{"description":"Company phone number","example":"+1-555-0135","type":"string"},"phone_status_cd":{"description":"Phone validation status","type":"string"},"raw_address":{"description":"Company address","example":"123 Main St, San Francisco, CA 94105","type":"string"},"salesforce_id":{"description":"Salesforce account ID for CRM integration","example":"001pJNj9pix2idKsfj","type":"string"},"twitter_url":{"description":"Twitter profile URL","example":"https://twitter.com/acme","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Custom field values as key-value pairs where key is the field_id and value is the field_value","example":{"507f1f77bcf86cd799439020":"High Value","507f1f77bcf86cd799439021":"Q4 2025"},"type":"object"}},"type":"object"},"maxItems":100,"type":"array"},"append_label_names":{"description":"Array of label names to add to ALL accounts in this request","example":["Enterprise","High Priority"],"items":{"type":"string"},"type":"array"},"run_dedupe":{"default":false,"description":"Enable aggressive deduplication by domain, organization_id, and name. When false (default), only matches by CRM IDs. When true, also matches by domain, organization_id, and name. Existing accounts are returned without modification in both modes","example":true,"type":"boolean"}},"required":["accounts"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"created_accounts":{"description":"Accounts created in this request","type":"string"},"created_accounts[].account_stage_id":{"description":"Account stage ID","type":"string"},"created_accounts[].created_at":{"description":"Created timestamp","type":"string"},"created_accounts[].domain":{"description":"Account domain","type":"string"},"created_accounts[].id":{"description":"Account ID","type":"string"},"created_accounts[].name":{"description":"Account name","type":"string"},"created_accounts[].owner_id":{"description":"Owner ID","type":"string"},"created_accounts[].phone":{"description":"Phone number","type":"string"},"created_accounts[].team_id":{"description":"Team ID","type":"string"},"created_accounts[].updated_at":{"description":"Updated timestamp","type":"string"},"existing_accounts":{"description":"Accounts that already existed (dedupe matches)","type":"string"},"existing_accounts[].account_stage_id":{"description":"Account stage ID","type":"string"},"existing_accounts[].created_at":{"description":"Created timestamp","type":"string"},"existing_accounts[].domain":{"description":"Account domain","type":"string"},"existing_accounts[].id":{"description":"Account ID","type":"string"},"existing_accounts[].name":{"description":"Account name","type":"string"},"existing_accounts[].owner_id":{"description":"Owner ID","type":"string"},"existing_accounts[].phone":{"description":"Phone number","type":"string"},"existing_accounts[].team_id":{"description":"Team ID","type":"string"},"existing_accounts[].updated_at":{"description":"Updated timestamp","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk Create Accounts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-bulk-create","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:f7763c06d7c4d93b7b47d893b1bf76878cda9a4ecd209c8481dfb22261b912fa","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"1668e54e63f9"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_accounts_bulk_create","path":"/apis/v1/apollo/accounts/bulk_create"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts/bulk_create","x-aisa-validation":"provider"}},"/apis/v1/apollo/accounts/bulk_update":{"post":{"description":"Bulk update accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_accounts_bulk_update","requestBody":{"content":{"application/json":{"schema":{"properties":{"account_attributes":{"description":"Array of account objects with individual updates. Use this for applying different updates to each account.","items":{"properties":{"account_stage_id":{"description":"The Apollo account stage ID","example":"6095a710bd01d100a506d4b7","type":"string"},"id":{"description":"The account ID to update","example":"66e9abf95ac32901b20d1a0d","type":"string"},"name":{"description":"The account name","example":"Acme Corporation","type":"string"},"owner_id":{"description":"The Apollo user ID to assign as owner","example":"66302798d03b9601c7934ebf","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Custom field values as key-value pairs","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"required":["id"],"type":"object"},"type":"array"},"account_ids":{"description":"Array of account IDs to update with the same values. Use this for applying the same updates to multiple accounts.","example":["66e9abf95ac32901b20d1a0d","66e9a4db056fe802d331fb8a"],"items":{"type":"string"},"type":"array"},"account_stage_id":{"description":"When using account_ids, apply this account stage to all accounts","example":"6095a710bd01d100a506d4b7","type":"string"},"async":{"description":"Set to true to process updates asynchronously. Only available when using account_ids. Not supported with account_attributes.","example":false,"type":"boolean"},"name":{"description":"When using account_ids, apply this name to all accounts","example":"Updated Account Name","type":"string"},"owner_id":{"description":"When using account_ids, apply this owner to all accounts","example":"66302798d03b9601c7934ebf","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"accounts":{"description":"Updated accounts","type":"string"},"accounts[].account_stage_id":{"description":"Account stage ID","type":"string"},"accounts[].id":{"description":"Account ID","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk Update Accounts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-bulk-update","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:474ca4a88887d05ccc93b0bf12f3522c0f54b4ed63aae983fecf6f29f28ba9a2","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"cf3634b917bc"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_accounts_bulk_update","path":"/apis/v1/apollo/accounts/bulk_update"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts/bulk_update","x-aisa-validation":"provider"}},"/apis/v1/apollo/accounts/search":{"post":{"description":"Search for accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_accounts_search","requestBody":{"content":{"application/json":{"schema":{"properties":{"account_label_ids":{"description":"The Apollo IDs for the labels that you want to include in your search results. If you add multiple labels, Apollo will include all accounts connected to any of the labels, along with the other parameters, in the search results. Example: `['6095a710bd01d100a506d4ae']`","items":{"type":"string"},"type":"array"},"account_stage_ids":{"description":"The Apollo IDs for the account stages that you want to include in your search results. If you add multiple account stages, Apollo will include all accounts that match any of the stages, along with the other parameters, in the search results. Call the [list account stages endpoint](https://docs.apollo.io/reference/list-account-stages) to retrieve a list of all the account stage IDs available in your Apollo account. Example: `61b8e913e0f4d2012e3af74e`","items":{"type":"string"},"type":"array"},"page":{"description":"The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the `per_page` parameter to make search results navigable and improve the performance of the endpoint. Example: `4`","format":"int32","type":"integer"},"per_page":{"description":"The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the `page` parameter to navigate through the different pages of data. Example: `10`","format":"int32","type":"integer"},"q_organization_name":{"description":"Add keywords to narrow the search of the accounts in your team's Apollo account. Keywords should directly match at least part of an account's name. For example, searching the keyword `marketing` might return the result `NY Marketing Unlimited`, but not `NY Market Analysts`. This parameter only searches account names, not other account fields. Examples: `apollo`; `microsoft`; `marketing`","type":"string"},"sort_ascending":{"default":false,"description":"Set to `true` to sort the matching accounts in ascending order. This parameter must be used with `sort_by_field`. Otherwise, the sorting logic is not applied. Example: `true`","type":"boolean"},"sort_by_field":{"description":"Sort the matching accounts by 1 of the following options:\n- `account_last_activity_date`: The most recent activity date recorded first.\n- `account_created_at`: The most recently created first.\n- `account_updated_at`: The most recently updated first.","enum":["account_last_activity_date","account_created_at","account_updated_at"],"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"accounts":{"description":"Response array","items":{"additionalProperties":true,"description":"Account","type":"object"},"type":"array"},"breadcrumbs":{"description":"Response array","items":{"additionalProperties":true,"description":"Breadcrumb","type":"object"},"type":"array"},"disable_eu_prospecting":{"description":"Response field","type":"boolean"},"has_join":{"description":"Response field","type":"boolean"},"num_fetch_result":{"additionalProperties":true,"description":"Fetch-result metadata","type":["object","null"]},"pagination":{"additionalProperties":true,"description":"Pagination metadata","type":"object"},"partial_results_limit":{"description":"Response field","type":"integer"},"partial_results_only":{"description":"Response field","type":"boolean"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Search for Accounts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:65d160b4870a989bb16cd6f82cf2ab3f15f22d45989c43f24dee1754cac78353","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"5337238ad680"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_accounts_search","path":"/apis/v1/apollo/accounts/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/accounts/update_owners":{"post":{"description":"Update account owner for multiple accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_accounts_update_owners","parameters":[{"description":"Account IDs","in":"query","name":"account_ids[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"New owner ID","in":"query","name":"owner_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"accounts":{"description":"Updated accounts","type":"string"},"accounts[].crm_owner_id":{"description":"CRM owner ID","type":"string"},"accounts[].id":{"description":"Account ID","type":"string"},"accounts[].owner_id":{"description":"Owner ID","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update Account Owner for Multiple Accounts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-update-owners","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:ebf3e6437fc2830eedcd01c63d45a1e5f75850218ae86921de70a0b28f98c989","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"b306f4b49856"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_accounts_update_owners","path":"/apis/v1/apollo/accounts/update_owners"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts/update_owners","x-aisa-validation":"provider"}},"/apis/v1/apollo/accounts/{account_id}":{"patch":{"description":"Update fields on an existing account. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"patch_apollo_accounts_account_id","parameters":[{"description":"Account ID","in":"path","name":"account_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"account_stage_id":{"description":"The Apollo ID for the account stage to which you want to assign the account. Enter a different ID to update the account stage.
Call the list account stages endpoint to retrieve a list of all the account stage IDs available in your Apollo account.
If you do not specify the account stage, Apollo automatically assigns the account to a stage as determined by your team's Apollo account. To change the order of account stages, launch the Apollo product and go to Settings > Objects > Accounts. Then, access the Triggers tab and change the stage for when an account is created.
Example: `61b8e913e0f4d2012e3af74e`","type":"string"},"domain":{"description":"Update the domain name for the account. Do not include `www.` or similar.
Example: `apollo.io` or `microsoft.com`","type":"string"},"name":{"description":"Update the account's name. This should be a human-readable name.
Example: `The Fast Irish Copywriters`","type":"string"},"owner_id":{"description":"The ID for the account owner within your team's Apollo account. Enter a different ID to update the owner of the account.
Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.
Example: `66302798d03b9601c7934ebf`","type":"string"},"phone":{"description":"Update the primary phone number for the account.
This can be the phone number for the corporate headquarters, a branch location, or a direct dial to the primary point of contact for the account.
Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.
Examples: `555-555-0133`; `+44 7700 900852`","type":"string"},"raw_address":{"description":"Update the corporate location for the account. This can include a city, US state, and country.
Apollo matches the location you provide to the most applicable pre-defined location.
Examples: `Belfield, Dublin 4, Ireland`; `Dallas, United States`","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Add information to custom fields in Apollo.
Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.
To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.
Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"account":{"additionalProperties":true,"description":"Updated account","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update an Account","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/patch_apollo-accounts-account-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:c6c609623505688db26dd95353f0991586d005887951e8c06794cc7f09c954fa","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"1bd5d4692f7b"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"patch_apollo_accounts_account_id","path":"/apis/v1/apollo/accounts/{account_id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts/{account_id}","x-aisa-validation":"provider"}},"/apis/v1/apollo/accounts/{id}":{"get":{"description":"View an account by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_accounts_id","parameters":[{"description":"Account ID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"account":{"additionalProperties":true,"description":"Account","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"View an Account","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-accounts-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:b78318eff7340733efc7d827394839aecbb41a8b4ce9a7a92768a86278470ab3","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"8db59be70bfe"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_accounts_id","path":"/apis/v1/apollo/accounts/{id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/accounts/{id}","x-aisa-validation":"provider"}},"/apis/v1/apollo/contact_stages":{"get":{"description":"List contact stages. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_contact_stages","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contact_stages":{"description":"Contact stages list","type":"string"},"contact_stages[].category":{"description":"Category","type":"string"},"contact_stages[].display_name":{"description":"Display name","type":"string"},"contact_stages[].display_order":{"description":"Display order","type":"integer"},"contact_stages[].id":{"description":"Stage ID","type":"string"},"contact_stages[].ignore_trigger_override":{"description":"Ignore trigger override","type":"boolean"},"contact_stages[].is_meeting_set":{"description":"Is meeting set","type":"boolean"},"contact_stages[].name":{"description":"Name","type":"string"},"contact_stages[].team_id":{"description":"Team ID","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"List Contact Stages","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-contact-stages","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:a21be582d64d92b19be19fea8e62425cb670b473e3d1b55651667426c13f2f53","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"aa33947107f0"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_contact_stages","path":"/apis/v1/apollo/contact_stages"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contact_stages","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts":{"post":{"description":"Create a new contact. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_contacts","requestBody":{"content":{"application/json":{"examples":{"Create contact with deduplication":{"summary":"Create a new contact with deduplication enabled","value":{"email":"jane.doe@example.com","first_name":"Jane","last_name":"Doe","organization_name":"Example Corp","run_dedupe":true,"title":"Product Manager"}},"Create contact without deduplication":{"summary":"Create a new contact without deduplication (default behavior)","value":{"email":"john.smith@example.com","first_name":"John","last_name":"Smith","organization_name":"Example Corp","title":"Software Engineer"}}},"schema":{"properties":{"account_id":{"description":"The Apollo ID for the account. Example: `63f53afe4ceeca00016bdd2f`","type":"string"},"contact_stage_id":{"description":"The Apollo ID for the contact stage. Example: `6095a710bd01d100a506d4ae`","type":"string"},"corporate_phone":{"description":"The work/office phone number. Example: `+44 7700 900852`","type":"string"},"direct_phone":{"description":"The primary phone number. Example: `555-555-0133`","type":"string"},"email":{"description":"The email address of the contact. Example: `example@email.com`","type":"string"},"first_name":{"description":"The first name of the contact you want to create. Example: `Tim`","type":"string"},"home_phone":{"description":"The home phone number. Example: `555-555-0133`","type":"string"},"label_names":{"description":"Lists to which the contact belongs.","items":{"type":"string"},"type":"array"},"last_name":{"description":"The last name of the contact you want to create. Example: `Zheng`","type":"string"},"mobile_phone":{"description":"The mobile phone number. Example: `555-555-0133`","type":"string"},"organization_name":{"description":"The name of the contact's employer (company). Example: `apollo`","type":"string"},"other_phone":{"description":"Alternative phone number. Example: `555-555-0133`","type":"string"},"present_raw_address":{"description":"The personal location for the contact. Example: `Atlanta, United States`","type":"string"},"run_dedupe":{"default":false,"description":"Set to `true` to match against your existing contacts instead of always creating a new one. The default value is `false`.
When a match is found, Apollo **updates that existing contact in place** with the values you sent and returns it — the `id` in the response belongs to the pre-existing contact, not a new record. Fields you send overwrite the stored values, fields you omit are left untouched, and sending an empty value clears the field.
Matching is checked in order: `id`, CRM identifiers, `person_id`, `email` (against the contact's primary and additional emails), then name plus company. Because of the last rule, a contact can be matched and updated even when the email differs.
When deduplication is enabled, performance may be slightly impacted due to the additional matching checks. See the endpoint description for full details.","type":"boolean"},"title":{"description":"The current job title that the contact holds. Example: `senior research analyst`","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Add information to custom fields in Apollo.
Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.
To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.
Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"},"website_url":{"description":"The corporate website URL. Example: `https://www.apollo.io/`","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contact":{"additionalProperties":true,"description":"Created contact","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Create a Contact","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-contacts","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:4a7a89e75801ee9b730b52cfaa6f1a5adbc9c398baee076590a1c293291e7ac0","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c14358c33fd6"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_contacts","path":"/apis/v1/apollo/contacts"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts/bulk_create":{"post":{"description":"Bulk create contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_contacts_bulk_create","requestBody":{"content":{"application/json":{"examples":{"Basic Contact Creation":{"value":{"contacts":[{"email":"john.doe@example.com","first_name":"John","last_name":"Doe","organization_name":"Acme Corporation","title":"Senior Manager"},{"email":"jane.smith@example.com","first_name":"Jane","last_name":"Smith","linkedin_url":"https://www.linkedin.com/in/jane-smith-4c8e21a9","organization_name":"TechStart Inc","title":"VP of Sales"}]}},"With CRM IDs (Returns Existing Without Updating)":{"value":{"contacts":[{"email":"john.doe@example.com","first_name":"John","last_name":"Doe","phone":"+1-555-0159","salesforce_contact_id":"003xx000004TmiQAAS"},{"email":"jane.smith@example.com","first_name":"Jane","hubspot_id":"12345678","last_name":"Smith"}]}},"With Custom Fields and Labels":{"value":{"append_label_names":["VIP","Decision Maker"],"contacts":[{"contact_stage_id":"507f1f77bcf86cd799439014","email":"sarah.whitfield@example.com","first_name":"Sarah","last_name":"Whitfield","organization_name":"Enterprise Corp","title":"CTO","typed_custom_fields":{"60c39ed82bd02f01154c470a":"2025-12-31","60c39ed82bd02f01154c470b":"High Priority"}}]}},"With Full Deduplication (Returns Existing Without Updating)":{"value":{"contacts":[{"email":"existing@example.com","first_name":"New","last_name":"Name","title":"New Title"}],"run_dedupe":true}},"With Multiple Contact Details":{"value":{"contacts":[{"contact_emails":[{"email":"michael.brown@example.com","position":0},{"email":"mbrown@example.com","position":1}],"first_name":"Michael","last_name":"Brown","organization_name":"Tech Solutions","phone_numbers":[{"position":0,"raw_number":"+1-555-0135"},{"position":1,"raw_number":"+1-555-0122"}]}]}},"With Top-Level Owner Assignment":{"value":{"contacts":[{"account_id":"507f1f77bcf86cd799439011","email":"alice.chen@example.com","first_name":"Alice","last_name":"Chen","organization_name":"CloudCo","title":"Director of Engineering"},{"account_id":"507f1f77bcf86cd799439011","email":"bob.lee@example.com","first_name":"Bob","last_name":"Lee","organization_name":"CloudCo","title":"Head of Product"}],"owner_id":"507f1f77bcf86cd799439013"}}},"schema":{"properties":{"append_label_names":{"description":"Array of label names to add to ALL contacts in this request","example":["Hot Lead","Q1 2024"],"items":{"type":"string"},"type":"array"},"contacts":{"description":"Array of contact objects to create (maximum 100 contacts per request)","items":{"properties":{"account_id":{"description":"Associated account ID","example":"507f1f77bcf86cd799439011","type":"string"},"contact_emails":{"description":"Array of email objects with position","items":{"properties":{"email":{"example":"john.doe@example.com","type":"string"},"position":{"example":0,"type":"integer"}},"type":"object"},"type":"array"},"contact_stage_id":{"description":"Contact stage ID","example":"507f1f77bcf86cd799439014","type":"string"},"email":{"description":"Contact's email address","example":"john.doe@example.com","type":"string"},"facebook_url":{"description":"Facebook profile URL","example":"https://www.facebook.com/johndoe","type":"string"},"first_name":{"description":"Contact's first name","example":"John","type":"string"},"hubspot_id":{"description":"HubSpot ID for matching and deduplication","example":"12345678","type":"string"},"last_name":{"description":"Contact's last name","example":"Doe","type":"string"},"linkedin_url":{"description":"LinkedIn profile URL","example":"https://www.linkedin.com/in/john-doe-3f9a7c21","type":"string"},"organization_id":{"description":"Associated organization ID","example":"507f1f77bcf86cd799439012","type":"string"},"organization_name":{"description":"Company/organization name","example":"Acme Corporation","type":"string"},"outreach_id":{"description":"Outreach.io ID","example":"98765","type":"string"},"phone":{"description":"Phone number","example":"+1-555-0135","type":"string"},"phone_numbers":{"description":"Array of phone number objects","items":{"properties":{"position":{"example":0,"type":"integer"},"raw_number":{"example":"+1-555-0135","type":"string"}},"type":"object"},"type":"array"},"phone_status_cd":{"description":"Phone validation status","type":"string"},"photo_url":{"description":"Profile photo URL","example":"https://example.com/photo.jpg","type":"string"},"present_raw_address":{"description":"Physical address","example":"San Francisco, CA","type":"string"},"primary_title":{"description":"Primary job title (takes precedence over title)","example":"VP of Sales","type":"string"},"salesforce_account_id":{"description":"Salesforce Account ID","example":"001pJNj9pix2idKsfj","type":"string"},"salesforce_contact_id":{"description":"Salesforce Contact ID for matching","example":"003xx000004TmiQAAS","type":"string"},"salesforce_id":{"description":"Salesforce ID for matching and deduplication","example":"003xx000004TmiQAAS","type":"string"},"salesforce_lead_id":{"description":"Salesforce Lead ID","example":"00Qxx000001abcDEFG","type":"string"},"salesloft_id":{"description":"SalesLoft ID","example":"54321","type":"string"},"title":{"description":"Contact's job title","example":"Senior Manager","type":"string"},"twitter_url":{"description":"Twitter profile URL","example":"https://twitter.com/johndoe","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Custom field values as key-value pairs where key is the field_id and value is the field_value","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"type":"object"},"maxItems":100,"type":"array"},"owner_id":{"description":"Owner user ID applied to all contacts in this batch. Defaults to current user if omitted. Returns 422 if the ID does not belong to the current team.","example":"507f1f77bcf86cd799439013","type":"string"},"run_dedupe":{"default":false,"description":"Enable full deduplication across all sources. When false (default), creates duplicates for non-email_import sources and merges with email_import placeholders only. When true, returns existing contacts in `existing_contacts` without modifying them (except email_import placeholders, which are still merged).
Matching is checked in order: `id`, CRM identifiers, `person_id`, `email` (against the contact's primary and additional emails), then name plus company (matched on email domain, `organization_id`, or `organization_name`).
Unlike create a contact, this endpoint never overwrites a matched contact's fields.","example":true,"type":"boolean"}},"required":["contacts"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"created_contacts":{"description":"Contacts created in this request","type":"string"},"created_contacts[].account_id":{"description":"Account ID","type":"string"},"created_contacts[].email":{"description":"Email","type":"string"},"created_contacts[].first_name":{"description":"First name","type":"string"},"created_contacts[].id":{"description":"Contact ID","type":"string"},"created_contacts[].last_name":{"description":"Last name","type":"string"},"created_contacts[].organization_name":{"description":"Organization name","type":"string"},"created_contacts[].owner_id":{"description":"Owner ID","type":"string"},"created_contacts[].phone_numbers":{"description":"Phone numbers","type":"string"},"created_contacts[].title":{"description":"Title","type":"string"},"created_contacts[].typed_custom_fields":{"description":"Typed custom fields object","type":"object"},"created_contacts[].updated_at":{"description":"Updated timestamp","type":"string"},"existing_contacts":{"description":"Contacts that already existed (dedupe matches)","type":"string"},"existing_contacts[].account_id":{"description":"Account ID","type":"string"},"existing_contacts[].email":{"description":"Email","type":"string"},"existing_contacts[].first_name":{"description":"First name","type":"string"},"existing_contacts[].id":{"description":"Contact ID","type":"string"},"existing_contacts[].last_name":{"description":"Last name","type":"string"},"existing_contacts[].organization_name":{"description":"Organization name","type":"string"},"existing_contacts[].owner_id":{"description":"Owner ID","type":"string"},"existing_contacts[].phone_numbers":{"description":"Phone numbers","type":"string"},"existing_contacts[].title":{"description":"Title","type":"string"},"existing_contacts[].typed_custom_fields":{"description":"Typed custom fields object","type":"object"},"existing_contacts[].updated_at":{"description":"Updated timestamp","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk Create Contacts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-bulk-create","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:6db95cc0bca89268140a7b3a674922af9ffe88ffa2419ac0e558c288227532d7","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2b5c760150eb"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_contacts_bulk_create","path":"/apis/v1/apollo/contacts/bulk_create"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/bulk_create","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts/bulk_update":{"post":{"description":"Bulk update contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_contacts_bulk_update","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"required":["contact_ids"]},{"required":["contact_attributes"]}],"properties":{"account_id":{"description":"When using contact_ids, apply this account ID to all contacts","example":"63f53afe4ceeca00016bdd2f","type":"string"},"async":{"description":"Force asynchronous processing. Automatically enabled for >100 contacts.","example":false,"type":"boolean"},"contact_attributes":{"description":"Array of contact objects with individual updates. Use this for applying different updates to each contact.","items":{"properties":{"account_id":{"description":"The Apollo account ID to associate with the contact","example":"63f53afe4ceeca00016bdd2f","type":"string"},"email":{"description":"The contact's email address","example":"john.doe@example.com","type":"string"},"first_name":{"description":"The contact's first name","example":"John","type":"string"},"id":{"description":"The contact ID to update","example":"66e34b81740c50074e3d1bd4","type":"string"},"last_name":{"description":"The contact's last name","example":"Doe","type":"string"},"linkedin_url":{"description":"The contact's LinkedIn profile URL","example":"https://www.linkedin.com/in/john-doe-3f9a7c21","type":"string"},"organization_name":{"description":"The contact's organization name","example":"Example Corp","type":"string"},"owner_id":{"description":"The Apollo user ID to assign as owner","example":"66302798d03b9601c7934ebf","type":"string"},"present_raw_address":{"description":"The contact's location","example":"San Francisco, CA","type":"string"},"title":{"description":"The contact's job title","example":"Senior Manager","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Custom field values as key-value pairs","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"required":["id"],"type":"object"},"type":"array"},"contact_ids":{"description":"Array of contact IDs to update with the same values. Use this for applying the same updates to multiple contacts.","example":["66e34b81740c50074e3d1bd4","66e370fbf5f5c003f0e1d0cf"],"items":{"type":"string"},"type":"array"},"email":{"description":"When using contact_ids, apply this email to all contacts","example":"updated@example.com","type":"string"},"first_name":{"description":"When using contact_ids, apply this first name to all contacts","example":"Updated","type":"string"},"last_name":{"description":"When using contact_ids, apply this last name to all contacts","example":"Name","type":"string"},"linkedin_url":{"description":"When using contact_ids, apply this LinkedIn URL to all contacts","example":"https://www.linkedin.com/in/updated","type":"string"},"organization_name":{"description":"When using contact_ids, apply this organization name to all contacts","example":"Updated Corp","type":"string"},"owner_id":{"description":"When using contact_ids, apply this owner to all contacts","example":"66302798d03b9601c7934ebf","type":"string"},"present_raw_address":{"description":"When using contact_ids, apply this address to all contacts","example":"New York, NY","type":"string"},"title":{"description":"When using contact_ids, apply this title to all contacts","example":"Updated Title","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"When using contact_ids, apply these custom fields to all contacts","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"},"visible_entity_ids":{"description":"Specific contact IDs to return in the response (for performance)","example":["66e34b81740c50074e3d1bd4"],"items":{"type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contacts":{"description":"Updated contacts","type":"string"},"contacts[].account_id":{"description":"Account ID","type":"string"},"contacts[].email":{"description":"Email","type":"string"},"contacts[].first_name":{"description":"First name","type":"string"},"contacts[].id":{"description":"Contact ID","type":"string"},"contacts[].last_name":{"description":"Last name","type":"string"},"contacts[].linkedin_url":{"description":"LinkedIn URL","type":"string"},"contacts[].organization_name":{"description":"Organization name","type":"string"},"contacts[].owner_id":{"description":"Owner ID","type":"string"},"contacts[].present_raw_address":{"description":"Raw address","type":"string"},"contacts[].title":{"description":"Title","type":"string"},"contacts[].updated_at":{"description":"Updated timestamp","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk Update Contacts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-bulk-update","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:7e5e49de66f415fd4b46f63967d1df7ada1864416b815f70e6ce941324bc6b06","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"94f381c5855a"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_contacts_bulk_update","path":"/apis/v1/apollo/contacts/bulk_update"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/bulk_update","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts/search":{"post":{"description":"Search for contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_contacts_search","requestBody":{"content":{"application/json":{"schema":{"properties":{"contact_label_ids":{"description":"The Apollo IDs for the labels that you want to include in your search results. If you add multiple labels, Apollo will include all contacts connected to any of the labels, along with the other parameters, in the search results. Example: `['6095a710bd01d100a506d4ae']`","items":{"type":"string"},"type":"array"},"contact_stage_ids":{"description":"The Apollo IDs for the contact stages that you want to include in your search results. If you add multiple contact stages, Apollo will include all contacts that match any of the stages, along with the other parameters, in the search results. Call the [list contact stages endpoint](https://docs.apollo.io/reference/list-contact-stages) to retrieve a list of all the contact stage IDs available in your Apollo account. Example: `6095a710bd01d100a506d4ae`","items":{"type":"string"},"type":"array"},"page":{"description":"The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the `per_page` parameter to make search results navigable and improve the performance of the endpoint. Example: `4`","format":"int32","type":"integer"},"per_page":{"description":"The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the `page` parameter to search the different pages of data. Example: `10`","format":"int32","type":"integer"},"q_keywords":{"description":"Add a keyword search string to narrow the contacts in your team's Apollo account. Keywords should be related to the same search concept and can include names, job titles, employers or company names, or email addresses. Examples: `matthew helm`; `CEO`; `Sumware Software`","type":"string"},"sort_ascending":{"default":false,"description":"Set to `true` to sort the matching contacts in ascending order. This parameter must be used with `sort_by_field`. Otherwise, the sorting logic is not applied. Example: `true`","type":"boolean"},"sort_by_field":{"description":"Sort the matching contacts by 1 of the following options: \n- `contact_last_activity_date`: The most recent activity date recorded first.\n- `contact_email_last_opened_at`: The most recent email opened date first.\n- `contact_email_last_clicked_at`: The most recent email clicked first.\n- `contact_created_at`: The most recently created first.\n- `contact_updated_at`: The most recently updated first.","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"breadcrumbs":{"description":"Response array","items":{"additionalProperties":true,"description":"Breadcrumb","type":"object"},"type":"array"},"contacts":{"description":"Response array","items":{"additionalProperties":true,"description":"Contact","type":"object"},"type":"array"},"disable_eu_prospecting":{"description":"Response field","type":"boolean"},"has_join":{"description":"Response field","type":"boolean"},"num_fetch_result":{"additionalProperties":true,"description":"Fetch-result metadata","type":["object","null"]},"pagination":{"additionalProperties":true,"description":"Pagination metadata","type":"object"},"partial_results_limit":{"description":"Response field","type":"integer"},"partial_results_only":{"description":"Response field","type":"boolean"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Search for Contacts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:f0949578236317d865eed847df369e73df3bec4f013e0a62254b4c1535d13e0a","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"44ba30e71231"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_contacts_search","path":"/apis/v1/apollo/contacts/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts/update_owners":{"post":{"description":"Update contact owner for multiple contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_contacts_update_owners","parameters":[{"description":"Contact IDs","in":"query","name":"contact_ids[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"New owner ID","in":"query","name":"owner_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contacts":{"description":"Updated contacts","type":"string"},"contacts[].crm_owner_id":{"description":"CRM owner ID","type":"string"},"contacts[].id":{"description":"Contact ID","type":"string"},"contacts[].owner_id":{"description":"Owner ID","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update Contact Owner for Multiple Contacts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-update-owners","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:e9f921d031285d6202c523deaf09685e6d2c8a02f38ad5c1111ecfcdb7c16ecd","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"0426b96b52da"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_contacts_update_owners","path":"/apis/v1/apollo/contacts/update_owners"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/update_owners","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts/update_stages":{"post":{"description":"Update contact stage for multiple contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_contacts_update_stages","parameters":[{"description":"Contact IDs","in":"query","name":"contact_ids[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"New contact stage ID","in":"query","name":"contact_stage_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contacts":{"description":"Updated contacts","type":"string"},"contacts[].contact_stage_id":{"description":"Contact stage ID","type":"string"},"contacts[].email":{"description":"Email","type":"string"},"contacts[].first_name":{"description":"First name","type":"string"},"contacts[].id":{"description":"Contact ID","type":"string"},"contacts[].last_name":{"description":"Last name","type":"string"},"contacts[].organization_name":{"description":"Organization name","type":"string"},"contacts[].owner_id":{"description":"Owner ID","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update Contact Stage for Multiple Contacts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-update-stages","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:3aa0c49e3b57c9b058730769dd9206767af6828f536a1293b0ace908a4c26a6c","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e0da0245de25"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_contacts_update_stages","path":"/apis/v1/apollo/contacts/update_stages"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/update_stages","x-aisa-validation":"provider"}},"/apis/v1/apollo/contacts/{contact_id}":{"get":{"description":"View a contact by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_contacts_contact_id","parameters":[{"description":"Contact ID","in":"path","name":"contact_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contact":{"description":"Contact object","type":"object"},"contact.account_id":{"description":"Account ID","type":"string"},"contact.email":{"description":"Email","type":"string"},"contact.first_name":{"description":"First name","type":"string"},"contact.id":{"description":"Contact ID","type":"string"},"contact.last_name":{"description":"Last name","type":"string"},"contact.linkedin_url":{"description":"LinkedIn URL","type":"string"},"contact.organization_name":{"description":"Organization name","type":"string"},"contact.owner_id":{"description":"Owner ID","type":"string"},"contact.phone_numbers":{"description":"Phone numbers","type":"string"},"contact.phone_numbers[].raw_number":{"description":"Raw number","type":"string"},"contact.phone_numbers[].sanitized_number":{"description":"Sanitized number","type":"string"},"contact.present_raw_address":{"description":"Raw address","type":"string"},"contact.title":{"description":"Title","type":"string"},"contact.updated_at":{"description":"Updated timestamp","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update or View Contact","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-contacts-contact-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:cafc79beae687d287801fffd66c369b5c3734b4e87ae1edc007d04c233911814","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"bdbc0c09ed7e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_contacts_contact_id","path":"/apis/v1/apollo/contacts/{contact_id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/{contact_id}","x-aisa-validation":"provider"},"patch":{"description":"View a contact by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"patch_apollo_contacts_contact_id","parameters":[{"description":"Contact ID","in":"path","name":"contact_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Update the account ID. Example: `63f53afe4ceeca00016bdd2f`","type":"string"},"contact_stage_id":{"description":"Update the contact stage ID. Example: `6095a710bd01d100a506d4af`","type":"string"},"corporate_phone":{"description":"Work/office phone.","type":"string"},"direct_phone":{"description":"Primary phone.","type":"string"},"email":{"description":"Update the contact email. Example: `example@email.com`","type":"string"},"first_name":{"description":"Update the contact's first name. Example: `Tim`","type":"string"},"home_phone":{"description":"Home phone.","type":"string"},"label_names":{"description":"Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)","items":{"type":"string"},"type":"array"},"last_name":{"description":"Update the contact's last name. Example: `Zheng`","type":"string"},"mobile_phone":{"description":"Mobile phone.","type":"string"},"organization_name":{"description":"Update the employer (company) name. Example: `apollo`","type":"string"},"other_phone":{"description":"Alternate phone.","type":"string"},"present_raw_address":{"description":"Update location (city/state/country). Example: `Atlanta, United States`","type":"string"},"title":{"description":"Update the job title. Example: `senior research analyst`","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Add information to custom fields in Apollo.
Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.
To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.
Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"},"website_url":{"description":"Update the employer website URL. Example: `https://www.apollo.io/`","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"contact":{"description":"Updated contact","type":"object"},"contact.account_id":{"description":"Account ID","type":"string"},"contact.email":{"description":"Email","type":"string"},"contact.first_name":{"description":"First name","type":"string"},"contact.id":{"description":"Contact ID","type":"string"},"contact.last_name":{"description":"Last name","type":"string"},"contact.organization_name":{"description":"Organization name","type":"string"},"contact.owner_id":{"description":"Owner ID","type":"string"},"contact.present_raw_address":{"description":"Raw address","type":"string"},"contact.title":{"description":"Title","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update or View Contact","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/patch_apollo-contacts-contact-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:af9a5661bc0af5f5a5bf37e030b661f98a1d48a01a5506ee56ba354272e5ab8f","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"bdbc0c09ed7e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_contacts_contact_id","path":"/apis/v1/apollo/contacts/{contact_id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/contacts/{contact_id}","x-aisa-validation":"provider"}},"/apis/v1/apollo/email_accounts":{"get":{"description":"Get a list of email accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_email_accounts","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"email_accounts":{"description":"Email accounts (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of Email Accounts","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-email-accounts","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:469561e98eb7969b4c20abc036c4856a38898ba2b23a779ecec5ee4241e7650e","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"b3dee57d06be"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_email_accounts","path":"/apis/v1/apollo/email_accounts"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/email_accounts","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids":{"post":{"description":"Update contact status in a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_emailer_campaigns_remove_or_stop_contact_ids","parameters":[{"description":"Contact IDs.","in":"query","name":"contact_ids[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Sequence IDs.","in":"query","name":"emailer_campaign_ids[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"One of: mark_as_finished, remove, stop.","in":"query","name":"mode","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"description":"Whether the update succeeded (when returned).","type":"boolean"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update Contact Status in a Sequence","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-remove-or-stop-contact-ids","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:20a3de1cca78a177acf6ca961db49d2b2e1f232b43dc020e82021ae12f72afdd","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6c0be94ded0d"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_emailer_campaigns_remove_or_stop_contact_ids","path":"/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_campaigns/remove_or_stop_contact_ids","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_campaigns/search":{"post":{"description":"Search for sequences (emailer campaigns) in your Apollo account. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_emailer_campaigns_search","parameters":[{"description":"Page number.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Results per page.","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Keywords to match sequence names.","in":"query","name":"q_name","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"emailer_campaigns":{"description":"Sequence records (when returned).","items":{"type":"string"},"type":"array"},"pagination":{"description":"Pagination metadata (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Search for Sequences","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:d63cb1faae10a7de1ece34d1438668c85e1a473353310a0b8bdf48f2fcd7e5ee","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"ea9942cfeddf"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_emailer_campaigns_search","path":"/apis/v1/apollo/emailer_campaigns/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_campaigns/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort":{"post":{"description":"Deactivate a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_emailer_campaigns_sequence_id_abort","parameters":[{"description":"Sequence ID.","in":"path","name":"sequence_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"emailer_campaign":{"description":"Sequence object (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Deactivate a Sequence","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-abort","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:cc8ac3b8dd33e2200fb7a7f8636765d9dfa40d36d68c2eee5fe0f8a0978bec69","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a8c903c4af9f"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_emailer_campaigns_sequence_id_abort","path":"/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_campaigns/{sequence_id}/abort","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids":{"post":{"description":"Add contacts to a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_emailer_campaigns_add_contact_ids","parameters":[{"description":"Sequence (emailer campaign) ID.","in":"path","name":"sequence_id","required":true,"schema":{"type":"string"}},{"description":"Contact IDs to add. Provide either contact_ids[] or label_names[] (or both).","in":"query","name":"contact_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Sequence ID (same as sequence_id).","in":"query","name":"emailer_campaign_id","required":true,"schema":{"type":"string"}},{"description":"Label names for contacts to add. Provide either label_names[] or contact_ids[] (or both).","in":"query","name":"label_names[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Email account ID (or IDs) to send from.","in":"query","name":"send_email_from_email_account_id","required":true,"schema":{"type":"string"}},{"description":"Optional from-address alias.","in":"query","name":"send_email_from_email_address","required":false,"schema":{"type":"string"}},{"description":"Allow contacts active in other sequences.","in":"query","name":"sequence_active_in_other_campaigns","required":false,"schema":{"type":"boolean"}},{"description":"Allow contacts finished in other sequences.","in":"query","name":"sequence_finished_in_other_campaigns","required":false,"schema":{"type":"boolean"}},{"description":"Allow contacts with job change.","in":"query","name":"sequence_job_change","required":false,"schema":{"type":"boolean"}},{"description":"Allow contacts without email.","in":"query","name":"sequence_no_email","required":false,"schema":{"type":"boolean"}},{"description":"Allow contacts with unverified email.","in":"query","name":"sequence_unverified_email","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"description":"Whether the add succeeded (when returned).","type":"boolean"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Add Contacts to a Sequence","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-add-contact-ids","x-aisa-identity":{"canonical_operation_id":"post_apollo_emailer_campaigns_add_contact_ids","historical_aliases":[{"canonical_source_file":"openapi/apollo.json","canonical_source_sha256":"b862a76afba7c6821b6e4d0264d7567ab5fa442c566ee276024f846d86728764","locale":"zh","method":"POST","operation_id":"post_apollo_emailer_campaigns_sequence_id_add_contact_ids","public_path":"/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids","published_ref":"e0ee9af05d7407976af62a72ac4e3499703a4f6a","source_file":"openapi/zh/apollo.json","source_sha256":"0240b36a721716c71cb7587813f7a832e0bb2b519b49217f73ff607666837815"}],"schema_version":1,"sha256":"sha256:baa386af467f49a315a1a8b2cd4aad7e66819e0d87e80b085a4d9e7e509f9f09"},"x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:378788aae1190adc12379d13624c91cde312b4bf816d349850128e222b2d20d2","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e80bfe3cd1aa"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_emailer_campaigns_add_contact_ids","path":"/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_campaigns/{sequence_id}/add_contact_ids","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve":{"post":{"description":"Activate a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_emailer_campaigns_sequence_id_approve","parameters":[{"description":"Sequence ID.","in":"path","name":"sequence_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"emailer_campaign":{"description":"Sequence object (when returned).","type":"object"},"emailer_steps":{"description":"Sequence steps (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Activate a Sequence","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-approve","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:17990a9d32d4c8022e561bd01e09d8118e5a6afa0834309add3f41477f6834d2","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"8539cc0b9640"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_emailer_campaigns_sequence_id_approve","path":"/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_campaigns/{sequence_id}/approve","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive":{"post":{"description":"Archive a sequence (marks it inactive and finishes contacts). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_emailer_campaigns_sequence_id_archive","parameters":[{"description":"Sequence ID.","in":"path","name":"sequence_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"emailer_campaign":{"description":"Archived sequence object (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Archive a Sequence","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-archive","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:94e1663e0669adaa3bded728593875c4f78a6cedb98427852645c0a4262a0d09","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"f7fb9165ac2b"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_emailer_campaigns_sequence_id_archive","path":"/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_campaigns/{sequence_id}/archive","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_messages/search":{"get":{"description":"Search for outreach emails. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_emailer_messages_search","parameters":[{"description":"Filter by email account and aliases.","in":"query","name":"email_account_id_and_aliases","required":false,"schema":{"type":"string"}},{"description":"Only include these sequence IDs.","in":"query","name":"emailer_campaign_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter by reply classes.","in":"query","name":"emailer_message_reply_classes[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter by message stats (e.g., open, click).","in":"query","name":"emailer_message_stats[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Exclude these sequence IDs.","in":"query","name":"not_emailer_campaign_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Page number.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Results per page.","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Filter by user IDs.","in":"query","name":"user_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"emailer_messages":{"description":"Outreach emails (when returned).","items":{"type":"string"},"type":"array"},"pagination":{"description":"Pagination metadata (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Search for Outreach Emails","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-emailer-messages-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:196f05db7e420b16f773463af71c8550de29f4218ac836f55bbf48db98603aac","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"ca78f0166a41"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_emailer_messages_search","path":"/apis/v1/apollo/emailer_messages/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_messages/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/emailer_messages/{id}/activities":{"get":{"description":"Check email stats for a specific outreach email. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_emailer_messages_id_activities","parameters":[{"description":"Emailer message ID.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"activities":{"description":"Activity events (when returned).","items":{"type":"string"},"type":"array"},"emailer_message":{"description":"Email object (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Check Email Stats","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-emailer-messages-id-activities","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:8ea33aecc718e3981106b0b615b8a7006415d6b1119d8cbceecb5f33677268af","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2ac7981241ee"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_emailer_messages_id_activities","path":"/apis/v1/apollo/emailer_messages/{id}/activities"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/emailer_messages/{id}/activities","x-aisa-validation":"provider"}},"/apis/v1/apollo/fields":{"get":{"description":"Get a list of fields. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_fields","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"fields":{"description":"Field definitions (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of Fields + Create a Custom Field","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-fields","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:6fdc4268c35253f368ecec0d72600008a9c7db4d8e8b68ea177fb69f39080242","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c54be117335c"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_fields","path":"/apis/v1/apollo/fields"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/fields","x-aisa-validation":"provider"},"post":{"description":"Get a list of fields. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_fields","requestBody":{"content":{"application/json":{"schema":{"properties":{"label":{"description":"Name of the custom field you want to create. Example: `Test Name`","type":"string"},"meta":{"properties":{"max_length":{"type":"number"}},"type":"object"},"modality":{"description":"The modality of the custom field you want to create. Example: `contact`","enum":["contact","account","opportunity"],"type":"string"},"type":{"description":"What kind of custom field you want to create. Example: `textarea`","enum":["string","textarea","number","date","datetime","boolean"],"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"typed_custom_fields":{"description":"Created field(s) (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of Fields + Create a Custom Field","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-fields","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:3f54e177b12e8bd94d3679845152cecf81a8680027c03ea1014dad1fa85395a0","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c54be117335c"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_fields","path":"/apis/v1/apollo/fields"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/fields","x-aisa-validation":"provider"}},"/apis/v1/apollo/labels":{"get":{"description":"Get a list of all lists (labels). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_labels","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"[]":{"description":"List objects (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of All Lists","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-labels","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:8486d4434b6bbc5e4728ff013d13a8894b38f756f016fcb252a080a215c8b522","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"20baefe1a96b"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_labels","path":"/apis/v1/apollo/labels"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/labels","x-aisa-validation":"provider"}},"/apis/v1/apollo/mixed_companies/search":{"post":{"description":"Find companies matching criteria: name, domain, headcount, industry, location, funding stage and technologies in use. Returns `organizations` and `accounts` side by side — organizations are Apollo's global database, accounts are records that already exist in this Apollo workspace — plus `pagination` and `breadcrumbs` echoing the filters that were applied. Use it to build a target list. When you already know the domain, `get_apollo_organizations_enrich` answers directly and costs less.\n\n\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_mixed_companies_search","parameters":[{"description":"Find organizations based on the technologies they currently use. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org","in":"query","name":"currently_using_any_of_technology_uids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The maximium amount the company received with its most recent funding round. Use this parameter in combination with latest_funding_amount_range[min] to set a monetary range for the company's most recent funding round. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 5000000; 15000000","in":"query","name":"latest_funding_amount_range[max]","required":false,"schema":{"type":"integer"}},{"description":"The minimum amount the company received with its most recent funding round. Use this parameter in combination with latest_funding_amount_range[max] to set a monetary range for the company's most recent funding round. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 5000000; 15000000","in":"query","name":"latest_funding_amount_range[min]","required":false,"schema":{"type":"integer"}},{"description":"The latest date when the company received its most recent funding round. Use this parameter in combination with latest_funding_date_range[min] to set a date range for when the company received its most recent funding round. Example: 2025-09-25","in":"query","name":"latest_funding_date_range[max]","required":false,"schema":{"type":"string"}},{"description":"The earliest date when the company received its most recent funding round. Use this parameter in combination with latest_funding_date_range[max] to set a date range for when the company received its most recent funding round. Example: 2025-07-25","in":"query","name":"latest_funding_date_range[min]","required":false,"schema":{"type":"string"}},{"description":"The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, identify the values for organization_id when you call this endpoint. Example: 5e66b6381e05b4008c8331b8","in":"query","name":"organization_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The locations of the jobs being actively recruited by the company. Examples: atlanta; japan","in":"query","name":"organization_job_locations[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The latest date when jobs were posted by the company. Use this parameter in combination with organization_job_posted_at_range[min] to set a date range for when jobs posted. Example: 2025-09-25","in":"query","name":"organization_job_posted_at_range[max]","required":false,"schema":{"type":"string"}},{"description":"The earliest date when jobs were posted by the company. Use this parameter in combination with organization_job_posted_at_range[max] to set a date range for when jobs posted. Example: 2025-07-25","in":"query","name":"organization_job_posted_at_range[min]","required":false,"schema":{"type":"string"}},{"description":"The location of the company headquarters. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appearch in your search results, even if they match other parameters.. To exclude companies based on location, use the organization_not_locations parameter. Examples: texas; tokyo; spain","in":"query","name":"organization_locations[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Exclude companies from search results based on the location of the company headquarters. You can use cities, US states, and countries as locations to exclude. This parameter is useful for ensuring you do not prospect in an undesirable territory. For example, if you use ireland as a value, no Ireland-based companies will appear in your search results. Examples: minnesota; ireland; seoul","in":"query","name":"organization_not_locations[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. Examples: 1,10; 250,500; 10000,20000","in":"query","name":"organization_num_employees_ranges[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The maximum number of job postings active at the company. Use this parameter in combination with organization_num_jobs_range[min] to set a job postings range. Examples: 50; 500","in":"query","name":"organization_num_jobs_range[max]","required":false,"schema":{"type":"integer"}},{"description":"The minimum number of job postings active at the company. Use this parameter in combination with organization_num_jobs_range[max] to set a job postings range. Examples: 50; 500","in":"query","name":"organization_num_jobs_range[min]","required":false,"schema":{"type":"integer"}},{"description":"The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. This parameter accepts up to 1,000 domains in a single request. Examples: apollo.io; microsoft.com","in":"query","name":"q_organization_domains_list[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The job titles that are listed in active job postings at the company. Examples: sales manager; research analyst","in":"query","name":"q_organization_job_titles[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter search results based on keywords associated with companies. For example, you can enter mining as a value to return only companies that have an association with the mining industry. Examples: mining; sales strategy; consulting","in":"query","name":"q_organization_keyword_tags[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter search results to include a specific company name. If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted. For example, if you filter by the value marketing, a company called NY Marketing Unlimited would still be eligible as a search result, but NY Market Analysis would not be eligible. Example: apollo or mining","in":"query","name":"q_organization_name","required":false,"schema":{"type":"string"}},{"description":"Search for organizations based on their revenue. Use this parameter to set the upper range of organization revenue. Use the revenue_range[min] parameter to set the lower range of revenue. Do not enter currency symbols, commas, or decimal points in the figure. Example: 50000000","in":"query","name":"revenue_range[max]","required":false,"schema":{"type":"integer"}},{"description":"Search for organizations based on their revenue. Use this parameter to set the lower range of organization revenue. Use the revenue_range[max] parameter to set the upper range of revenue. Do not enter currency symbols, commas, or decimal points in the figure. Example: 300000","in":"query","name":"revenue_range[min]","required":false,"schema":{"type":"integer"}},{"description":"The maximum amount the company received during all of its funding rounds combined. Use this parameter in combination with total_funding_range[min] to set a monetary range for all of the company's funding rounds. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 50000000; 350000000","in":"query","name":"total_funding_range[max]","required":false,"schema":{"type":"integer"}},{"description":"The minimum amount the company received during all of its funding rounds combined. Use this parameter in combination with total_funding_range[max] to set a monetary range for all of the company's funding rounds. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 50000000; 350000000","in":"query","name":"total_funding_range[min]","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"accounts":{"description":"Response array","items":{"type":"string"},"type":"array"},"breadcrumbs":{"description":"Response array","items":{"type":"string"},"type":"array"},"derived_params":{"description":"Response field","type":"string"},"disable_eu_prospecting":{"description":"Response field","type":"boolean"},"has_join":{"description":"Response field","type":"boolean"},"model_ids":{"description":"Response array","items":{"type":"string"},"type":"array"},"num_fetch_result":{"description":"Response field","type":"string"},"organizations":{"description":"Response array","items":{"type":"string"},"type":"array"},"pagination":{"description":"Response object","type":"object"},"partial_results_limit":{"description":"Response field","type":"integer"},"partial_results_only":{"description":"Response field","type":"boolean"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Organization Search","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-mixed-companies-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"plan_units","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01975,"estimate_source":"profile_seed","evidence_source":"request_snapshot","request_cost_drivers":{"formula":{"fixed_units":1},"inputs":[],"kind":"plan_units"},"unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:1f45818067049a6b7dc82cdd0ee0b61bc76df6942634a91aa84a15432ab995ae","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"dd7f50354676","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"85473a16cd94"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_mixed_companies_search","path":"/apis/v1/apollo/mixed_companies/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/mixed_companies/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/mixed_people/api_search":{"post":{"description":"Use the People API Search endpoint to find net new people in the Apollo database. Several filters are available to help narrow your search. This endpoint is optimized for API usage and does not consume credits. This endpoint is primarily designed for prospecting net new people. This endpoint does not return email addresses or phone numbers. Use the People Enrichment or Bulk People Enrichment endpoints to enrich data. This endpoint requires a master API key. Refer to Create API Keys to learn how to create a master API key. To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_mixed_people_api_search","parameters":[{"description":"The email statuses for the people you want to find. You can add multiple statuses to expand your search. The statuses you can search include: verified unverified likely to engage unavailable","in":"query","name":"contact_email_status[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Exclude people from your search based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org","in":"query","name":"currently_not_using_any_of_technology_uids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Find people based on all of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org","in":"query","name":"currently_using_all_of_technology_uids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Find people based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org","in":"query","name":"currently_using_any_of_technology_uids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"This parameter determines whether people with job titles similar to the titles you define in the person_titles[] parameter are returned in the response. Set this parameter to false when using person_titles[] to return only strict matches for job titles.","in":"query","name":"include_similar_titles","required":false,"schema":{"type":"boolean"}},{"description":"The Apollo IDs for the companies (employers) you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, call the Organization Search endpoint and identify the values for organization_id. Example: 5e66b6381e05b4008c8331b8","in":"query","name":"organization_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The locations of the jobs being actively recruited by the person's employer. Examples: atlanta; japan","in":"query","name":"organization_job_locations[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The latest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[min] to set a date range for when jobs posted. Example: 2025-09-25","in":"query","name":"organization_job_posted_at_range[max]","required":false,"schema":{"type":"string"}},{"description":"The earliest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[max] to set a date range for when jobs posted. Example: 2025-07-25","in":"query","name":"organization_job_posted_at_range[min]","required":false,"schema":{"type":"string"}},{"description":"The location of the company headquarters for a person's current employer. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, people that work for the Boston-based company will not appear in your results, even if they match other parameters. To find people based on their personal location, use the person_locations parameter. Examples: texas; tokyo; spain","in":"query","name":"organization_locations[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The number range of employees working for the person's current company. This enables you to find people based on the headcount of their employer. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. Examples: 1,10; 250,500; 10000,20000","in":"query","name":"organization_num_employees_ranges[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The maximum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[min] to set a job postings range. Examples: 50; 500","in":"query","name":"organization_num_jobs_range[max]","required":false,"schema":{"type":"integer"}},{"description":"The minimum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[max] to set a job postings range. Examples: 50; 500","in":"query","name":"organization_num_jobs_range[min]","required":false,"schema":{"type":"integer"}},{"description":"The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"The location where people live. You can search across cities, US states, and countries. To find people based on the headquarters locations of their current employer, use the organization_locations parameter. Examples: california; ireland; chicago","in":"query","name":"person_locations[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The job seniority that people hold within their current employer. This enables you to find people that currently hold positions at certain reporting levels, such as Director level or senior IC level. For a person to be included in search results, they only need to match 1 of the seniorities you add. Adding more seniorities expands your search results. Searches only return results based on their current job title, so searching for Director-level employees only returns people that currently hold a Director-level title. If someone was previously a Director, but is currently a VP, they would not be included in your search results. Use this parameter in combination with the person_titles[] parameter to find people based on specific job functions and seniority levels. The following options can be used for this parameter: owner founder c_suite partner vp head director manager senior entry intern","in":"query","name":"person_seniorities[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Job titles held by the people you want to find. For a person to be included in search results, they only need to match 1 of the job titles you add. Adding more job titles expands your search results. Results also include job titles with the same terms, even if they are not exact matches. For example, searching for marketing manager might return people with the job title content marketing manager. Use this parameter in combination with the person_seniorities[] parameter to find people based on specific job functions and seniority levels. Examples: sales development representative; marketing manager; research analyst","in":"query","name":"person_titles[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"A string of words over which we want to filter the results.","in":"query","name":"q_keywords","required":false,"schema":{"type":"string"}},{"description":"The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. This parameter accepts up to 1,000 domains in a single request. Examples: apollo.io; microsoft.com","in":"query","name":"q_organization_domains_list[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The job titles that are listed in active job postings at the person's current employer. Examples: sales manager; research analyst","in":"query","name":"q_organization_job_titles[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The maximum revenue the person's current employer generates. Use this parameter in combination with revenue_range[min] to set a revenue range. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 500000; 1500000","in":"query","name":"revenue_range[max]","required":false,"schema":{"type":"integer"}},{"description":"The minimum revenue the person's current employer generates. Use this parameter in combination with revenue_range[max] to set a revenue range. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 500000; 1500000","in":"query","name":"revenue_range[min]","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"people":{"description":"Response array","items":{"type":"string"},"type":"array"},"total_entries":{"description":"Response field","type":"integer"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"People API Search","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-mixed-people-api-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:08ddce7098c773abc6b4b27451fdcb73ad2ef835516913c5256323218e8aa1e8","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"1ecb8de294fc"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_mixed_people_api_search","path":"/apis/v1/apollo/mixed_people/api_search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/mixed_people/api_search","x-aisa-validation":"provider"}},"/apis/v1/apollo/news_articles/search":{"post":{"description":"News coverage for specific companies. `organization_ids[]` is required — omitting it returns HTTP 422 with \"organization_ids is required\", so resolve the companies first with `get_apollo_organizations_enrich` or `post_apollo_mixed_companies_search`. Narrow further with `categories[]` (funding, hires, launches and similar), `published_at[min]`, `published_at[max]`, and page with `page` and `per_page`. Returns `news_articles` and `pagination`. Use it to catch a trigger event before reaching out.\n\n\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_news_articles_search","parameters":[{"description":"Filter your search to include only certain categories or sub-categories of news. Use the News search filter for companies within Apollo to uncover all possible categories and sub-categories. Examples: hires; investment; contract","in":"query","name":"categories[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, call the Organization Search endpoint and identify the values for organization_id. Example: 5e66b6381e05b4008c8331b8","in":"query","name":"organization_ids[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Set the upper bound of the date range you want to search. Use this parameter in combination with the published_at[min] parameter. This date should fall after the published_at[min] date. The date should be formatted as YYYY-MM-DD. Example: 2025-05-15","in":"query","name":"published_at[max]","required":false,"schema":{"type":"string"}},{"description":"Set the lower bound of the date range you want to search. Use this parameter in combination with the published_at[max] parameter. This date should fall before the published_at[max] date. The date should be formatted as YYYY-MM-DD. Example: 2025-02-15","in":"query","name":"published_at[min]","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"news_articles":{"description":"Response array","items":{"type":"string"},"type":"array"},"pagination":{"description":"Response object","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"News Articles Search","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-news-articles-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"plan_units","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01975,"estimate_source":"profile_seed","evidence_source":"request_snapshot","request_cost_drivers":{"formula":{"fixed_units":1},"inputs":[],"kind":"plan_units"},"unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:690317cf0435061d76d0543a41ec7b8deac6b156fa7555cd95c420dee2770afa","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"dd7f50354676","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"257b8e819ad7"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_news_articles_search","path":"/apis/v1/apollo/news_articles/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/news_articles/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/notes":{"get":{"description":"Get a list of notes. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_notes","parameters":[{"description":"Filter by an account ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"account_id","required":false,"schema":{"type":"string"}},{"description":"Filter by a calendar event ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"calendar_event_id","required":false,"schema":{"type":"string"}},{"description":"Filter by a contact ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"contact_id","required":false,"schema":{"type":"string"}},{"description":"Filter by contact IDs. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"contact_ids","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter by a conversation ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"conversation_id","required":false,"schema":{"type":"string"}},{"description":"Filter by conversation IDs. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"conversation_ids","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Filter by an opportunity ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"opportunity_id","required":false,"schema":{"type":"string"}},{"description":"Page number (when supported). At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Results per page (when supported). At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Only include notes created on/after this date (when supported). At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".","in":"query","name":"start_date","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"notes":{"description":"Notes (when returned).","items":{"type":"string"},"type":"array"},"pagination":{"description":"Pagination metadata (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of Notes","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-notes","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:73d236ae796a8952f34d241eec1ce6b8cefb8d62b2f32786b2da7b0ec65738f5","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e65c63c8eb8f"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_notes","path":"/apis/v1/apollo/notes"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/notes","x-aisa-validation":"provider"}},"/apis/v1/apollo/opportunities":{"post":{"description":"Create a deal (opportunity). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_opportunities","requestBody":{"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"The ID for the account within your Apollo instance. This is the company that you are targeting as part of the deal being created.
Each company in the Apollo database is assigned a unique ID. To find IDs, call the organization search endpoint and identify the values for `organization_id`.
Example: `5e66b6381e05b4008c8331b8`","type":"string"},"amount":{"description":"The monetary value of the deal being created.
Do not enter commas or currency symbols for the value. The currency is automatically populated by the settings within your Apollo account. Commas are not accepted and result in the deal amount being left blank.
Example: `55123478` (results in a deal value of `$55,123,478` if the default currency is USD)","type":"string"},"closed_date":{"description":"The estimated close date for the deal. This can be a future or past date.
The date should be formatted as `YYYY-MM-DD`.
Example: `2025-10-30`","format":"date","type":"string"},"name":{"description":"Name the deal you are creating. This should be a human-readable name.
Example: `Massive Q3 Deal`","type":"string"},"opportunity_stage_id":{"description":"The ID for the deal stage within your team's Apollo account.
Each deal stage is assigned a unique ID. To find deal stage IDs, call the list deal stages endpoint and identify the value for `id` for each stage.
Example: `6095a710bd01d100a506d4bd`","type":"string"},"owner_id":{"description":"The ID for the deal owner within your team's Apollo account.
Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.
Example: `66302798d03b9601c7934ebf`","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Add information to custom fields in Apollo.
Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.
To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.
Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"required":["name"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"opportunity":{"additionalProperties":true,"description":"Created opportunity","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Create Deal","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-opportunities","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:9660b5489f920f328232720d6a9d192f195dd5e91e2f0276622905b4014a5b83","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"f1307a28b15a"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_opportunities","path":"/apis/v1/apollo/opportunities"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/opportunities","x-aisa-validation":"provider"}},"/apis/v1/apollo/opportunities/search":{"get":{"description":"List all deals (opportunities). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_opportunities_search","parameters":[{"description":"Page number","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Items per page","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Sort field","in":"query","name":"sort_by_field","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"opportunities":{"description":"Opportunities list","type":"string"},"opportunities[].account_id":{"description":"Account ID","type":"string"},"opportunities[].amount":{"description":"Amount","type":"number"},"opportunities[].created_at":{"description":"Created timestamp","type":"string"},"opportunities[].id":{"description":"Opportunity ID","type":"string"},"opportunities[].is_closed":{"description":"Is closed","type":"boolean"},"opportunities[].is_won":{"description":"Is won","type":"boolean"},"opportunities[].name":{"description":"Name","type":"string"},"opportunities[].opportunity_stage_id":{"description":"Stage ID","type":"string"},"opportunities[].owner_id":{"description":"Owner ID","type":"string"},"pagination":{"description":"Pagination object","type":"object"},"pagination.page":{"description":"Page number","type":"integer"},"pagination.per_page":{"description":"Items per page","type":"integer"},"pagination.total_entries":{"description":"Total entries","type":"integer"},"pagination.total_pages":{"description":"Total pages","type":"integer"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"List All Deals","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-opportunities-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:5729bb495a1e76ad490d4d5ccc0b75255537d9500f75675aeeb7289910c18b02","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"546b2f93deac"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_opportunities_search","path":"/apis/v1/apollo/opportunities/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/opportunities/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/opportunities/{opportunity_id}":{"get":{"description":"View a deal (opportunity) by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_opportunities_opportunity_id","parameters":[{"description":"Opportunity ID","in":"path","name":"opportunity_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"opportunity":{"description":"Opportunity object","type":"object"},"opportunity.account_id":{"description":"Account ID","type":"string"},"opportunity.amount":{"description":"Amount","type":"number"},"opportunity.created_at":{"description":"Created timestamp","type":"string"},"opportunity.id":{"description":"Opportunity ID","type":"string"},"opportunity.is_closed":{"description":"Is closed","type":"boolean"},"opportunity.is_won":{"description":"Is won","type":"boolean"},"opportunity.name":{"description":"Name","type":"string"},"opportunity.opportunity_stage_id":{"description":"Stage ID","type":"string"},"opportunity.owner_id":{"description":"Owner ID","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"View or Update Deal","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-opportunities-opportunity-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:97549b29b88b7b563c41b8968d653958327d4168689404a79361f99bce152dd5","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6b7c5496f6f4"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_opportunities_opportunity_id","path":"/apis/v1/apollo/opportunities/{opportunity_id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/opportunities/{opportunity_id}","x-aisa-validation":"provider"},"patch":{"description":"View a deal (opportunity) by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"patch_apollo_opportunities_opportunity_id","parameters":[{"description":"Opportunity ID","in":"path","name":"opportunity_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"amount":{"description":"The monetary value of the deal. Enter a different value to update the deal amount.
Do not enter commas or currency symbols for the value. The currency is automatically populated by the settings within your Apollo account. Commas are not accepted and result in the deal amount being left blank.
Example: `55123478` (results in a deal value of `$55,123,478` if the default currency is USD)","type":"string"},"closed_date":{"description":"Update the estimated close date for the deal. This can be a future or past date.
The date should be formatted as `YYYY-MM-DD`.
Example: `2025-10-30`","format":"date","type":"string"},"name":{"description":"Update the name of the deal. This should be a human-readable name.
Example: `Massive Q3 Deal`","type":"string"},"opportunity_stage_id":{"description":"The ID for the deal stage within your team's Apollo account. Enter a different ID to update the deal stage.
Each deal stage is assigned a unique ID. To find deal stage IDs, call the list deal stages endpoint and identify the value for `id` for each stage.
Example: `6095a710bd01d100a506d4bd`","type":"string"},"owner_id":{"description":"The ID for the deal owner within your team's Apollo account. Enter a different ID to update the owner of the deal.
Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.
Example: `66302798d03b9601c7934ebf`","type":"string"},"typed_custom_fields":{"additionalProperties":{"type":"string"},"description":"Add information to custom fields in Apollo.
Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.
To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.
Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`","example":{"60c39ed82bd02f01154c470a":"2025-08-07"},"type":"object"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"opportunity":{"additionalProperties":true,"description":"Updated opportunity","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"View or Update Deal","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/patch_apollo-opportunities-opportunity-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:057cec5799be2f45d3130f7f5883b4d3b5e92a3ed693d1e65911bc2590c70315","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6b7c5496f6f4"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_opportunities_opportunity_id","path":"/apis/v1/apollo/opportunities/{opportunity_id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/opportunities/{opportunity_id}","x-aisa-validation":"provider"}},"/apis/v1/apollo/opportunity_stages":{"get":{"description":"List deal stages (opportunity stages). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_opportunity_stages","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"opportunity_stages":{"description":"Opportunity stages list","type":"string"},"opportunity_stages[].description":{"description":"Description","type":"string"},"opportunity_stages[].display_order":{"description":"Display order","type":"integer"},"opportunity_stages[].forecast_category_cd":{"description":"Forecast category code","type":"string"},"opportunity_stages[].id":{"description":"Stage ID","type":"string"},"opportunity_stages[].is_closed":{"description":"Is closed","type":"boolean"},"opportunity_stages[].is_won":{"description":"Is won","type":"boolean"},"opportunity_stages[].name":{"description":"Name","type":"string"},"opportunity_stages[].opportunity_pipeline_id":{"description":"Opportunity pipeline ID","type":"string"},"opportunity_stages[].probability":{"description":"Probability","type":"number"},"opportunity_stages[].team_id":{"description":"Team ID","type":"string"},"opportunity_stages[].type":{"description":"Type","type":"string"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"List Deal Stages","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-opportunity-stages","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:9eec6c1baffdfc121cc9b273a46fc5453a666de4eaad09172c01f628738ce5db","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"12970000620b"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_opportunity_stages","path":"/apis/v1/apollo/opportunity_stages"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/opportunity_stages","x-aisa-validation":"provider"}},"/apis/v1/apollo/organizations/bulk_enrich":{"post":{"description":"Enrich up to 10 companies in one call. Body takes `domains`, an array of bare domains. Returns the enriched organizations alongside `status`, `total_requested_domains`, `unique_domains`, `unique_records` and `unique_enriched_records` — compare the requested and enriched counts rather than assuming every domain resolved. For one domain `get_apollo_organizations_enrich` is a plain GET.\n\n\nUsage-based billing; Default request estimate: $0.1975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_organizations_bulk_enrich","parameters":[{"description":"The domain of each company that you want to enrich. Do not include www., the @ symbol, or similar. Example: apollo.io and microsoft.com","in":"query","name":"domains[]","required":true,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"error_code":{"description":"Response field","type":"string"},"error_message":{"description":"Response field","type":"string"},"missing_records":{"description":"Response field","type":"integer"},"organizations":{"description":"Response array","items":{"type":"string"},"type":"array"},"status":{"description":"Response field","type":"string"},"total_requested_domains":{"description":"Response field","type":"integer"},"unique_domains":{"description":"Response field","type":"integer"},"unique_enriched_records":{"description":"Response field","type":"integer"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk Organization Enrichment","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-organizations-bulk-enrich","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_count","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.1975,"estimate_source":"profile_seed","evidence_source":"response_body","maximum_units":10,"unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:34cd913109840173288457860b98874e42a20695acdb78696d39e79571a11a97","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"dd7f50354676","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2750fcc5c11e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_organizations_bulk_enrich","path":"/apis/v1/apollo/organizations/bulk_enrich"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/organizations/bulk_enrich","x-aisa-validation":"provider"}},"/apis/v1/apollo/organizations/enrich":{"get":{"description":"Enrich one company by domain. `domain` is the only parameter and it must be the bare domain (apple.com), not a full URL. Returns an `organization` object with `id`, `name`, `website_url`, `linkedin_url`, `twitter_url`, `facebook_url`, `angellist_url`, `phone`, `founded_year`, `alexa_ranking`, `publicly_traded_symbol`, `publicly_traded_exchange` and `languages`. Use it as the entry point when all you have is a domain. For several domains at once use `post_apollo_organizations_bulk_enrich`; for the full record including funding and technology detail use `get_apollo_organizations_id`, which needs the Apollo organization id this call returns.\n\n\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_organizations_enrich","parameters":[{"description":"The domain of the company that you want to enrich. Do not include www., the @ symbol, or similar. Example: apollo.io or microsoft.com","in":"query","name":"domain","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"organization":{"description":"Response object","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Organization Enrichment","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-enrich","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"plan_units","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01975,"estimate_source":"profile_seed","evidence_source":"request_snapshot","request_cost_drivers":{"formula":{"fixed_units":1},"inputs":[],"kind":"plan_units"},"unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:5cea0efc1bf053916f6f5a3d31677ad11c5b364aab24a45ac629edf2e801e2ec","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"dd7f50354676","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"5fb0090dbb38"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_organizations_enrich","path":"/apis/v1/apollo/organizations/enrich"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/organizations/enrich","x-aisa-validation":"provider"}},"/apis/v1/apollo/organizations/{id}":{"get":{"description":"The complete Apollo record for one company, by Apollo organization id (not by domain). Returns an `organization` object carrying everything enrichment returns plus the deeper fields: funding history, technology stack, department headcounts and related organizations. Get the id from `get_apollo_organizations_enrich` or `post_apollo_mixed_companies_search` first — this endpoint cannot take a domain.\n\n\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_organizations_id","parameters":[{"description":"The Apollo ID for the organization that you want to research. To find organization IDs, call the Organization Search endpoint and identify the organizaton_id value for the organization. Example: 5e66b6381e05b4008c8331b8","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"organization":{"description":"Response object","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get Complete Organization Info","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"plan_units","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01975,"estimate_source":"profile_seed","evidence_source":"request_snapshot","request_cost_drivers":{"formula":{"fixed_units":1},"inputs":[],"kind":"plan_units"},"unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:5cea0efc1bf053916f6f5a3d31677ad11c5b364aab24a45ac629edf2e801e2ec","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"dd7f50354676","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"977a7bd8437c"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_organizations_id","path":"/apis/v1/apollo/organizations/{id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/organizations/{id}","x-aisa-validation":"provider"}},"/apis/v1/apollo/organizations/{organization_id}/job_postings":{"get":{"description":"Live job postings for one company, by Apollo organization id. Each posting carries its title, location, posted date and source URL. Useful as a hiring signal — which functions a company is expanding, and where. Get the organization id from `get_apollo_organizations_enrich` first. This reads Apollo's job board data, not the company's own careers page, so absence of postings is not proof a company is not hiring.\n\n\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_organizations_organization_id_job_postings","parameters":[{"description":"The organization ID of the company for which you want to find job postings. Each company in the Apollo database is assigned a unique ID. To find IDs, call the Organization Search endpoint and identify the values for organization_id. Example: 5e66b6381e05b4008c8331b8","in":"path","name":"organization_id","required":true,"schema":{"type":"string"}},{"description":"The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"organization_job_postings":{"description":"Response array","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Organization Job Postings","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-organization-id-job-postings","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"plan_units","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01975,"estimate_source":"profile_seed","evidence_source":"request_snapshot","request_cost_drivers":{"formula":{"fixed_units":1},"inputs":[],"kind":"plan_units"},"unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:1e98904de06a156205e936b43186b6f50fdfbdbd4fa6087e536caf45a5223652","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"dd7f50354676","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"0c80c8c2dfa4"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_organizations_organization_id_job_postings","path":"/apis/v1/apollo/organizations/{organization_id}/job_postings"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/organizations/{organization_id}/job_postings","x-aisa-validation":"provider"}},"/apis/v1/apollo/people/bulk_match":{"post":{"description":"Enrich up to 10 people in one call. Body takes `details`, an array of the same identifier objects `post_apollo_people_match` accepts. Returns `matches` alongside `status`, `total_requested_enrichments`, `unique_enriched_records`, `missing_records` and `credits_consumed` — read `missing_records` rather than assuming every input matched. Costs one credit per record enriched, not per call. Use this over a loop of single calls: same credits, one round trip. For a single person `post_apollo_people_match` is simpler.\n\n\nUsage-based billing; Default request estimate: $1.7775 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_people_bulk_match","parameters":[{"description":"Set to true if you want to enrich the data of all matched people with all available phone numbers, including mobile phone numbers. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If this parameter is set to true, you must enter a webhook URL for the webhook_url parameter. Apollo will asynchronously verify phone numbers for you, then send a JSON response that includes only details about the phone numbers to the webhook URL you provide. It can take several minutes for the phone numbers to be delivered.","examples":{"default":{"value":false}},"in":"query","name":"reveal_phone_number","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Set to true to enable email waterfall enrichment","examples":{"default":{"value":false}},"in":"query","name":"run_waterfall_email","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Set to true to enable phone waterfall enrichment","examples":{"default":{"value":false}},"in":"query","name":"run_waterfall_phone","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"If you set the reveal_phone_number parameter to true, this parameter becomes mandatory. Otherwise, do not use this parameter. Enter the webhook URL that specifies where Apollo should send a JSON response that includes the phone number you requested. Apollo suggests testing this flow to ensure you receive the separate response with the phone number. If phone numbers are not revealed delivered to the webhook URL, try applying UTF-8 encoding to the webhook URL. Example: https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40; https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40","in":"query","name":"webhook_url","required":false,"schema":{"format":"https_url","maxLength":2048,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"details":{"description":"Provide info for each person you want to enrich as an object within this array. Add up to 10 people.","items":{"description":"One person to enrich. Give whatever identifiers you have — the more, the likelier the match.","properties":{"domain":{"description":"Domain of the person's employer, without www. Example: apollo.io","type":"string"},"email":{"description":"Email address of the person.","type":"string"},"first_name":{"description":"First name, used with last_name. Example: tim","type":"string"},"hashed_email":{"description":"MD5 or SHA-256 hash of the email address.","type":"string"},"id":{"description":"Apollo person id, e.g. from a people search.","type":"string"},"last_name":{"description":"Last name, used with first_name. Example: zheng","type":"string"},"linkedin_url":{"description":"LinkedIn profile URL of the person.","type":"string"},"name":{"description":"Full name, e.g. \"tim zheng\"; replaces first_name + last_name.","type":"string"},"organization_name":{"description":"Name of the person's employer. Example: apollo","type":"string"}},"type":"object"},"type":"array"},"reveal_personal_emails":{"description":"Set to true if you want to enrich all matched people with personal emails. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If a person resides in a GDPR -compliant region, Apollo will not reveal their personal email.","type":"boolean"}},"required":["details"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"credits_consumed":{"description":"Response field","type":"integer"},"error_code":{"description":"Response field","type":"string"},"error_message":{"description":"Response field","type":"string"},"matches":{"description":"Response array","items":{"type":"string"},"type":"array"},"missing_records":{"description":"Response field","type":"integer"},"status":{"description":"Response field","type":"string"},"total_requested_enrichments":{"description":"Response field","type":"integer"},"unique_enriched_records":{"description":"Response field","type":"integer"},"waterfall":{"description":"Response object","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk People Enrichment","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-constraints":{"conditional_requirements":[{"if_any_boolean_true":[{"in":"query","name":"reveal_phone_number","selector":"reveal_phone_number"},{"in":"query","name":"run_waterfall_email","selector":"run_waterfall_email"},{"in":"query","name":"run_waterfall_phone","selector":"run_waterfall_phone"}],"require_all":[{"in":"query","name":"webhook_url","selector":"webhook_url"}]}]},"x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-people-bulk-match","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":1.7775,"estimate_source":"profile_seed","evidence_source":"response_body","unit":"provider_credit","unit_rate_usd":0},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:9dd58fde99c92aef856ad0f47b70d50086b0c7eff9baa8f3148006399f9b2a71","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"d10d440e9796","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"99241d7c699e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_people_bulk_match","path":"/apis/v1/apollo/people/bulk_match"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/people/bulk_match","x-aisa-validation":"mixed"}},"/apis/v1/apollo/people/match":{"post":{"description":"Enrich one person: give whatever identifiers you have and get back Apollo's full record for them. Send identifiers in the JSON request body, not the query string. Accepts `email`, `first_name` plus `last_name`, `name`, `domain`, `organization_name`, `linkedin_url` or `hashed_email` — the more you supply, the likelier the match. Returns a `person` object with `id`, `name`, `title`, `headline`, `linkedin_url`, `twitter_url`, `github_url`, `photo_url`, `organization_id` and an `employment_history` array, plus a `request_id`. Personal emails and phone numbers are withheld unless `reveal_personal_emails` (body) or `reveal_phone_number` (query) is set, and those cost extra credits. A 200 does not guarantee a match — check whether `person` actually came back. Use `post_apollo_people_bulk_match` for up to 10 people in one call; use `post_apollo_mixed_people_api_search` when you do not have an identifier and need to find candidates first.\n\n\nPublished reference price: $0.01975 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_people_match","parameters":[{"description":"Set to true if you want to enrich the person's data with all available phone numbers, including mobile phone numbers. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If this parameter is set to true, you must enter a webhook URL for the webhook_url parameter. Apollo will asynchronously verify phone numbers for you, then send a JSON response that includes only details about the person's phone numbers to the webhook URL you provide. It can take several minutes for the phone numbers to be delivered.","examples":{"default":{"value":false}},"in":"query","name":"reveal_phone_number","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Set to true to enable email waterfall enrichment","examples":{"default":{"value":false}},"in":"query","name":"run_waterfall_email","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Set to true to enable phone waterfall enrichment","examples":{"default":{"value":false}},"in":"query","name":"run_waterfall_phone","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"If you set the reveal_phone_number parameter to true, this parameter becomes mandatory. Otherwise, do not use this parameter. Enter the webhook URL that specifies where Apollo should send a JSON response that includes the phone number you requested. Apollo suggests testing this flow to ensure you receive the separate response with the phone number. If phone numbers are not revealed delivered to the webhook URL, try applying UTF-8 encoding to the webhook URL. Example: https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40; https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40","in":"query","name":"webhook_url","required":false,"schema":{"format":"https_url","maxLength":2048,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"domain":"apollo.io","name":"tim zheng"},"schema":{"anyOf":[{"properties":{"first_name":{"minLength":1,"type":"string"}},"required":["first_name"]},{"properties":{"last_name":{"minLength":1,"type":"string"}},"required":["last_name"]},{"properties":{"name":{"minLength":1,"type":"string"}},"required":["name"]},{"properties":{"email":{"minLength":1,"type":"string"}},"required":["email"]},{"properties":{"hashed_email":{"minLength":1,"type":"string"}},"required":["hashed_email"]},{"properties":{"organization_name":{"minLength":1,"type":"string"}},"required":["organization_name"]},{"properties":{"domain":{"minLength":1,"type":"string"}},"required":["domain"]},{"properties":{"id":{"minLength":1,"type":"string"}},"required":["id"]},{"properties":{"linkedin_url":{"minLength":1,"type":"string"}},"required":["linkedin_url"]}],"description":"Identify one person. Give at least one identifier; the more you supply, the likelier the match.","minProperties":1,"properties":{"domain":{"description":"The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. Example: apollo.io or microsoft.com","type":"string"},"email":{"description":"The email address of the person. Example: example@email.com","type":"string"},"first_name":{"description":"The first name of the person. This is typically used in combination with the last_name parameter. Example: tim","type":"string"},"hashed_email":{"description":"The hashed email of the person. The email should adhere to either the MD5 or SHA-256 hash format. Example: 8d935115b9ff4489f2d1f9249503cadf (MD5) or 97817c0c49994eb500ad0a5e7e2d8aed51977b26424d508f66e4e8887746a152 (SHA-256)","type":"string"},"id":{"description":"The Apollo ID for the person. Each person in the Apollo database is assigned a unique ID. To find IDs, call the People API Search endpoint and identify the values for person_id. Example: 587cf802f65125cad923a266","type":"string"},"last_name":{"description":"The last name of the person. This is typically used in combination with the first_name parameter. Example: zheng","type":"string"},"linkedin_url":{"description":"The URL for the person's LinkedIn profile. Example: http://www.linkedin.com/in/tim-zheng-677ba010","type":"string"},"name":{"description":"The full name of the person. This will typically be a first name and last name separated by a space. If you use this parameter, you do not need to use the first_name and last_name parameters. Example: tim zheng","type":"string"},"organization_name":{"description":"The name of the person's employer. This can be the current employer or a previous employer. Example: apollo","type":"string"},"reveal_personal_emails":{"description":"Set to true if you want to enrich the person's data with personal emails. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If a person resides in a GDPR -compliant region, Apollo will not reveal their personal email.","type":"boolean"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"person":{"description":"Response object","type":"object"},"waterfall":{"description":"Response object","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"People Enrichment","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-constraints":{"conditional_requirements":[{"if_any_boolean_true":[{"in":"query","name":"reveal_phone_number","selector":"reveal_phone_number"},{"in":"query","name":"run_waterfall_email","selector":"run_waterfall_email"},{"in":"query","name":"run_waterfall_phone","selector":"run_waterfall_phone"}],"require_all":[{"in":"query","name":"webhook_url","selector":"webhook_url"}]}]},"x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-people-match","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01975,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:7fadde251ef476cd68e84646c8c1e05b0edda6294f57904448bc4f2a3f8c6c70","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"d7af3fddf48b","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"8b83f4a4d426"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_people_match","path":"/apis/v1/apollo/people/match"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/people/match","x-aisa-validation":"mixed"}},"/apis/v1/apollo/phone_calls":{"post":{"description":"Create call records. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_phone_calls","parameters":[{"description":"Account ID.","in":"query","name":"account_id","required":false,"schema":{"type":"string"}},{"description":"Contact ID.","in":"query","name":"contact_id","required":false,"schema":{"type":"string"}},{"description":"Duration in seconds.","in":"query","name":"duration","required":false,"schema":{"type":"integer"}},{"description":"ISO 8601 end time.","in":"query","name":"end_time","required":false,"schema":{"type":"string"}},{"description":"Caller phone number.","in":"query","name":"from_number","required":false,"schema":{"type":"string"}},{"description":"Whether to create an individual record.","in":"query","name":"logged","required":false,"schema":{"type":"boolean"}},{"description":"Outcome ID.","in":"query","name":"phone_call_outcome_id","required":false,"schema":{"type":"string"}},{"description":"Purpose ID.","in":"query","name":"phone_call_purpose_id","required":false,"schema":{"type":"string"}},{"description":"ISO 8601 start time.","in":"query","name":"start_time","required":false,"schema":{"type":"string"}},{"description":"Call status.","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Dialed phone number.","in":"query","name":"to_number","required":false,"schema":{"type":"string"}},{"description":"Caller user IDs.","in":"query","name":"user_id[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"phone_call":{"description":"Call record (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Create Call Records","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-phone-calls","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:20b81e0c919f2ce8023dbb7aecf36febd6a5764facb4414906af4808b5a14464","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"b3e0eb13c5aa"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_phone_calls","path":"/apis/v1/apollo/phone_calls"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/phone_calls","x-aisa-validation":"provider"}},"/apis/v1/apollo/phone_calls/search":{"get":{"description":"Search calls. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_phone_calls_search","parameters":[{"description":"Contact label IDs.","in":"query","name":"contact_label_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Upper bound for call date range (YYYY-MM-DD).","in":"query","name":"date_range[max]","required":false,"schema":{"type":"string"}},{"description":"Lower bound for call date range (YYYY-MM-DD).","in":"query","name":"date_range[min]","required":false,"schema":{"type":"string"}},{"description":"Upper bound for duration (seconds).","in":"query","name":"duration[max]","required":false,"schema":{"type":"integer"}},{"description":"Lower bound for duration (seconds).","in":"query","name":"duration[min]","required":false,"schema":{"type":"integer"}},{"description":"Inbound or outbound.","in":"query","name":"inbound","required":false,"schema":{"type":"string"}},{"description":"Page number.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Results per page.","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Outcome IDs.","in":"query","name":"phone_call_outcome_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Purpose IDs.","in":"query","name":"phone_call_purpose_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Keyword filter.","in":"query","name":"q_keywords","required":false,"schema":{"type":"string"}},{"description":"User IDs.","in":"query","name":"user_ids[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pagination":{"description":"Pagination metadata (when returned).","type":"object"},"phone_calls":{"description":"Calls (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Search for Calls","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-phone-calls-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:0edd26c318e511a416d697c33f70ba395547391e86b8eafacef0180e2d07b999","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"912915ce0d0c"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_phone_calls_search","path":"/apis/v1/apollo/phone_calls/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/phone_calls/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/phone_calls/{id}":{"put":{"description":"Update call records. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"put_apollo_phone_calls_id","parameters":[{"description":"Call record ID.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Account ID.","in":"query","name":"account_id","required":false,"schema":{"type":"string"}},{"description":"Contact ID.","in":"query","name":"contact_id","required":false,"schema":{"type":"string"}},{"description":"Duration in seconds.","in":"query","name":"duration","required":false,"schema":{"type":"integer"}},{"description":"ISO 8601 end time.","in":"query","name":"end_time","required":false,"schema":{"type":"string"}},{"description":"Caller phone number.","in":"query","name":"from_number","required":false,"schema":{"type":"string"}},{"description":"Whether to create an individual record.","in":"query","name":"logged","required":false,"schema":{"type":"boolean"}},{"description":"Outcome ID.","in":"query","name":"phone_call_outcome_id","required":false,"schema":{"type":"string"}},{"description":"Purpose ID.","in":"query","name":"phone_call_purpose_id","required":false,"schema":{"type":"string"}},{"description":"ISO 8601 start time.","in":"query","name":"start_time","required":false,"schema":{"type":"string"}},{"description":"Call status.","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Dialed phone number.","in":"query","name":"to_number","required":false,"schema":{"type":"string"}},{"description":"Caller user IDs.","in":"query","name":"user_id[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"phone_call":{"description":"Updated call record (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Update Call Records","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/put_apollo-phone-calls-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:a65b8a23d363087b2289b42491b7ae4dd54ea33f25dd9edd9037a4a558cd906e","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c6143a5cb2a5"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"put_apollo_phone_calls_id","path":"/apis/v1/apollo/phone_calls/{id}"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/phone_calls/{id}","x-aisa-validation":"provider"}},"/apis/v1/apollo/reports/sync_report":{"post":{"description":"Query analytics report. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_reports_sync_report","requestBody":{"content":{"application/json":{"examples":{"Custom date range — call activity for Q1":{"value":{"date_ranges":[{"modality":"custom_range"}],"filters":{"smart_datetime_range":{"max":"2024-03-31","min":"2024-01-01"}},"group_by":[{"name":"smart_user_id"}],"group_by_totals_selected":true,"metrics":[{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_phone_calls"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_phone_calls_connect"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"percent_phone_calls_connect"}],"pivot_group_by":[],"pivot_group_by_totals_selected":false,"sorts":[]}},"Flat totals — email performance":{"value":{"date_ranges":[{"modality":"last_30_days"}],"filters":{},"group_by":[],"group_by_totals_selected":false,"metrics":[{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_sent"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_opened"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"percent_emails_opened_tracked"}],"pivot_group_by":[],"pivot_group_by_totals_selected":false,"sorts":[]}},"Grouped — email activity by user":{"value":{"date_ranges":[{"modality":"current_month"}],"filters":{},"group_by":[{"name":"smart_user_id"}],"group_by_totals_selected":true,"metrics":[{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_sent"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_replied"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"percent_emails_replied"}],"pivot_group_by":[],"pivot_group_by_totals_selected":false,"sorts":[{"asc":false,"metric":{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_sent"}}]}},"Grouped — email volume by month":{"value":{"date_ranges":[{"modality":"last_12_months"}],"filters":{},"group_by":[{"name":"smart_datetime_month"}],"group_by_totals_selected":false,"metrics":[{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_sent"}],"pivot_group_by":[],"pivot_group_by_totals_selected":false,"sorts":[]}},"Pivot — emails sent by user x contact stage":{"value":{"date_ranges":[{"modality":"last_30_days"}],"filters":{},"group_by":[{"name":"smart_user_id"}],"group_by_totals_selected":true,"metrics":[{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_sent"}],"pivot_group_by":[{"name":"contact_stage_id"}],"pivot_group_by_totals_selected":true,"sorts":[]}},"Sorted — top 5 reps by reply rate":{"value":{"date_ranges":[{"modality":"current_quarter"}],"filters":{},"group_by":[{"limit":5,"name":"smart_user_id"}],"group_by_totals_selected":false,"metrics":[{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_sent"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"num_emails_replied"},{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"percent_emails_replied"}],"pivot_group_by":[],"pivot_group_by_totals_selected":false,"sorts":[{"asc":false,"metric":{"smart_datetime_reference":"activity_datetime","smart_user_id_reference":"user_id","value":"percent_emails_replied"}}]}}},"schema":{"properties":{"date_ranges":{"description":"The time window for the query. Provide one object with a modality preset. For a custom date range, set modality to custom_range and add a smart_datetime_range key in filters with {\"min\": \"YYYY-MM-DD\", \"max\": \"YYYY-MM-DD\"}.","items":{"properties":{"modality":{"description":"Date range preset. Valid values: today, yesterday, current_week, current_month, current_quarter, current_year, last_7_days, last_2_weeks, last_30_days, last_3_months, last_6_months, last_12_months, last_4_quarters, last_2_years, previous_week, previous_month, previous_quarter, previous_year, all_time, custom_range (requires smart_datetime_range in filters).","type":"string"}},"required":["modality"],"type":"object"},"maxItems":1,"type":"array"},"filters":{"additionalProperties":true,"description":"Key/value filter map to narrow the result set. Pass an empty object {} for no filters. Common filter keys are documented in the properties below; additional dimension-based filters may also be passed using the same key names as group_by[].name values. Refer to the Metrics and Dimensions Reference for a complete list.","properties":{"account_stage_ids":{"description":"Filter to specific account stage IDs.","items":{"type":"string"},"type":"array"},"contact_stage_ids":{"description":"Filter to specific contact stage IDs.","items":{"type":"string"},"type":"array"},"email_account_ids":{"description":"Filter to specific sender mailbox IDs.","items":{"type":"string"},"type":"array"},"emailer_campaign_ids":{"description":"Filter to specific sequence IDs.","items":{"type":"string"},"type":"array"},"opportunity_stage_ids":{"description":"Filter to specific opportunity stage IDs.","items":{"type":"string"},"type":"array"},"smart_datetime_range":{"description":"Required when date_ranges[].modality is custom_range. Specifies the exact date window as ISO 8601 date strings.","properties":{"max":{"description":"End date (inclusive). Format: YYYY-MM-DD.
Example: 2024-03-31","type":"string"},"min":{"description":"Start date (inclusive). Format: YYYY-MM-DD.
Example: 2024-01-01","type":"string"}},"required":["min","max"],"type":"object"},"smart_subteam_id":{"description":"Filter to specific sub-team IDs.","items":{"type":"string"},"type":"array"},"smart_user_id":{"description":"Filter to specific team member IDs. Use \"current\" for the authenticated user.
Example: [\"current\"]","items":{"type":"string"},"type":"array"}},"type":"object"},"group_by":{"description":"The dimension to group results by (row dimension). Pass one object to break results down by that dimension. Pass an empty array [] for flat totals with no grouping.
Only one entry is supported. Refer to the Metrics and Dimensions Reference for valid dimension names.","items":{"properties":{"limit":{"description":"Maximum number of dimension values to return.","type":"integer"},"name":{"description":"The dimension name.
Example: smart_user_id","type":"string"}},"required":["name"],"type":"object"},"maxItems":1,"type":"array"},"group_by_totals_selected":{"description":"When true, the response includes an aggregated totals row in addition to the per-dimension-value rows.","type":"boolean"},"metrics":{"description":"The metrics to query. Each object specifies which metric to measure and which date and user columns the engine should use for that metric. The smart_datetime_reference and smart_user_id_reference values are metric-specific — using the wrong values will return no data. Refer to the Metrics and Dimensions Reference for valid metric names and the correct reference fields for each.
Pass an empty array [] to return a response with no metric columns.","items":{"properties":{"display_name":{"description":"Optional label override for this metric's column in the response.","type":"string"},"smart_datetime_reference":{"description":"The date column name to use for this metric time range. Valid values depend on the metric. See the smart reference field values table for supported values by metric type. Unsupported values may cause the related date or user filter not to apply.
Example: activity_datetime","type":"string"},"smart_user_id_reference":{"description":"The user column name that filters per user. Many metrics use user_id. See the smart reference field values table for supported values by metric family. Unsupported values may cause the related date or user filter not to apply.
Example: user_id","type":"string"},"value":{"description":"The metric identifier. For built-in metrics, use the metric name (e.g. num_emails_sent). For team-defined custom metrics, use the format custom_metric_{id} where {id} is the custom metric's id.","type":"string"}},"required":["value","smart_datetime_reference","smart_user_id_reference"],"type":"object"},"type":"array"},"min_ratio_denominator":{"default":0,"description":"Minimum denominator threshold for ratio metrics. Rows where the denominator falls below this value are excluded from ratio calculations.","type":"integer"},"pivot_group_by":{"description":"The dimension to pivot on (column dimension). Used together with group_by to produce a two-dimensional cross-tab table: group_by defines the row dimension and pivot_group_by defines the column dimension. Pass an empty array [] for non-pivot queries.
Only one entry is supported.","items":{"properties":{"limit":{"description":"Maximum number of pivot column values to return.","type":"integer"},"name":{"description":"The dimension name to pivot on.
Example: emailer_campaign_id","type":"string"}},"required":["name"],"type":"object"},"maxItems":1,"type":"array"},"pivot_group_by_totals_selected":{"description":"When true, the pivot response includes an aggregated totals column in addition to the per-pivot-value columns.","type":"boolean"},"skip_group_by_values":{"description":"Exclude specific dimension values from the result rows. Values must match the raw key field returned in bucket responses for the active group_by dimension (e.g. a contact stage ID string, a user ID string, or a date string for datetime dimensions). Maximum 500 entries.","items":{"type":"string"},"maxItems":500,"type":"array"},"sorts":{"description":"Sort order for the result rows. Only the first entry is applied. Pass an empty array [] to use the default order.
Sorting is supported by metric value — provide the metric field with the same structure as an entry in the metrics array. The asc field controls direction (true = ascending, false = descending).
Sorting by dimension value (e.g. alphabetically by user name) is not supported via the API.","items":{"properties":{"asc":{"description":"Sort ascending (true) or descending (false).","type":"boolean"},"metric":{"description":"Sort by a metric column. Provide the same structure as a metric entry in the metrics array.","properties":{"smart_datetime_reference":{"type":"string"},"smart_user_id_reference":{"type":"string"},"value":{"type":"string"}},"type":"object"}},"required":["asc"],"type":"object"},"type":"array"}},"required":["metrics","group_by","sorts","filters","group_by_totals_selected","pivot_group_by_totals_selected","date_ranges"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"report":{"description":"Report result (shape depends on request).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Query Analytics Report","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-reports-sync-report","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:ae97effd45080a298065849aa857fbaf8a76f86a4b6351abf6a27424b8308caf","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"7d41c50d34d4"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_reports_sync_report","path":"/apis/v1/apollo/reports/sync_report"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/reports/sync_report","x-aisa-validation":"provider"}},"/apis/v1/apollo/tasks":{"post":{"description":"Create a task. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_tasks","requestBody":{"content":{"application/json":{"examples":{"Create a call task":{"value":{"contact_id":"66e34b81740c50074e3d1bd4","due_at":"2025-02-15T10:00:00Z","note":"Discuss product demo results and next steps.","priority":"high","status":"scheduled","title":"Follow-up call","type":"call","user_id":"66302798d03b9601c7934ebf"}}},"schema":{"properties":{"contact_id":{"description":"The Apollo ID for the contact that you want to be on the receiving end of the action.
To find contact IDs, call the search for contacts endpoint and identify the `id` value for the contact.
Example: `66e34b81740c50074e3d1bd4`","type":"string"},"due_at":{"description":"The full date and time when the task will be due.
Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a task due date that falls on a different day than you intended.
The value you enter can either adhere to GMT, or you can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.
Example: `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00`","format":"date-time","type":"string"},"note":{"description":"Add a description for the task. This should be a human-readable message.
This parameter is not required, but it is recommended as it provides the task owner with more context on the action they need to take.
Example: `This contact expressed interest in the Sequences feature specifically. Be prepared to discuss.`","type":"string"},"priority":{"default":"medium","description":"Assign a priority to the task you are creating:
","type":"string"},"status":{"description":"The status of the task being created. For future-facing tasks, you should use the `scheduled` status.
For tasks that are already completed, you can use `completed` or `skipped`.
Example: `scheduled`","type":"string"},"title":{"description":"A title for the task. If omitted, Apollo will display an auto-generated title based on the task type and contact name.
Example: `Follow up on demo request`","type":"string"},"type":{"description":"Set the task to be 1 of the following task types. This enables the task owner to know the type of action they need to take.
","type":"string"},"user_id":{"description":"The ID for the task owner within your team's Apollo account. This is the user that will take action on the contacts.
Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.
Example: `66302798d03b9601c7934ebf`","type":"string"}},"required":["user_id","contact_id","type","status","due_at"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"task":{"description":"Created task (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Create a Task","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-tasks","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:1c7f8afc5a0294a06f10a4a723834141f5080dc1a9f95ab39aa27e1fd0e540a7","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"b6cbc7704368"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_tasks","path":"/apis/v1/apollo/tasks"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/tasks","x-aisa-validation":"provider"}},"/apis/v1/apollo/tasks/bulk_create":{"post":{"description":"Bulk create tasks. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_tasks_bulk_create","requestBody":{"content":{"application/json":{"examples":{"Create call tasks for multiple contacts":{"value":{"contact_ids":["66e34b81740c50074e3d1bd4","66e34b81740c50074e3d1bd5","66e34b81740c50074e3d1bd6"],"due_at":"2025-02-15T10:00:00Z","note":"Follow up on demo request.","priority":"high","status":"scheduled","type":"call","user_id":"66302798d03b9601c7934ebf"}}},"schema":{"properties":{"contact_ids":{"description":"The Apollo IDs for the contacts that you want to be on the receiving end of the action.
If you add multiple contact IDs, individual tasks will be created for each of the contacts using the same task type, due date, and other details.
To find contact IDs, call the search for contacts endpoint and identify the `id` value for the contact.
Example: `66e34b81740c50074e3d1bd4`","items":{"type":"string"},"type":"array"},"due_at":{"description":"The full date and time when the task will be due.
Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a task due date that falls on a different day than you intended.
The value you enter can either adhere to GMT, or you can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.
Example: `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00`","format":"date-time","type":"string"},"note":{"description":"Add a description for the task. This should be a human-readable message.
This parameter is not required, but it is recommended as it provides the task owner with more context on the action they need to take.
Example: `This contact expressed interest in the Sequences feature specifically. Be prepared to discuss.`","type":"string"},"priority":{"default":"medium","description":"Assign a priority to the task you are creating:
","type":"string"},"status":{"description":"The status of the task being created. For future-facing tasks, you should use the `scheduled` status.
For tasks that are already completed, you can use `completed` or `skipped`.
Example: `scheduled`","type":"string"},"type":{"description":"Set the task to be 1 of the following task types. This enables the task owner to know the type of action they need to take.
","type":"string"},"user_id":{"description":"The ID for the task owner within your team's Apollo account. This is the user that will take action on the contacts.
Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.
Example: `66302798d03b9601c7934ebf`","type":"string"}},"required":["user_id","contact_ids","type","status","due_at"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tasks":{"description":"Created tasks (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Bulk Create Tasks","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-tasks-bulk-create","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:c3870ec62b396db3e3e8d411319708092a7e633eefb94d826ee24e5553916ece","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"067dc0b7ba35"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_tasks_bulk_create","path":"/apis/v1/apollo/tasks/bulk_create"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/tasks/bulk_create","x-aisa-validation":"provider"}},"/apis/v1/apollo/tasks/search":{"post":{"description":"Search tasks. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_tasks_search","parameters":[{"description":"Optional open factors.","in":"query","name":"open_factor_names[]","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Page number.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Results per page.","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}},{"description":"Sort field.","in":"query","name":"sort_by_field","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pagination":{"description":"Pagination metadata (when returned).","type":"object"},"tasks":{"description":"Tasks (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Search for Tasks","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-tasks-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:5d93524b30f8a9f38278015fa9c462080eff7e674b91b9103a0f41425ad8f06c","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"353382a4d1bb"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_tasks_search","path":"/apis/v1/apollo/tasks/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/tasks/search","x-aisa-validation":"provider"}},"/apis/v1/apollo/typed_custom_fields":{"get":{"description":"Get a list of all custom fields. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_typed_custom_fields","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"typed_custom_fields":{"description":"Custom field definitions (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of All Custom Fields","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-typed-custom-fields","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:8ee4f8924bdf96bee8e7d02165ccd27caad15ec66b7d923806337655d2be5400","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"231fb84a1493"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_typed_custom_fields","path":"/apis/v1/apollo/typed_custom_fields"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/typed_custom_fields","x-aisa-validation":"provider"}},"/apis/v1/apollo/usage_stats/api_usage_stats":{"post":{"description":"View API usage stats and rate limits. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_apollo_usage_stats_api_usage_stats","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"api_usage_stats":{"description":"Usage stats and rate limits (when returned).","type":"object"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"View API Usage Stats and Rate Limits","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/post_apollo-usage-stats-api-usage-stats","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:12c87854a68b04a8d41d3e27462c546d9a38af322e71a38555003a6bbfdc6862","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a942568990c3"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_apollo_usage_stats_api_usage_stats","path":"/apis/v1/apollo/usage_stats/api_usage_stats"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/usage_stats/api_usage_stats","x-aisa-validation":"provider"}},"/apis/v1/apollo/users/search":{"get":{"description":"Get a list of users. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_apollo_users_search","parameters":[{"description":"Page number.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Results per page.","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pagination":{"description":"Pagination metadata (when returned).","type":"object"},"users":{"description":"Users (when returned).","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get a List of Users","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"apollo","x-aisa-category":"14","x-aisa-docs-url":"https://aisa.one/docs/api-reference/apollo/get_apollo-users-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_pricing":"fixed_success","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"apollo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"apollo","x-aisa-response-source":{"content_hash":"sha256:172657926cf5336ede0f8bca5f63044fa460b90460e6c27a36e1762b26b09a46","kind":"upstream_success_contract","source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"}},"x-aisa-revision":{"customer_pricing_ref":"613706296d43","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"101335a2c464"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_apollo_users_search","path":"/apis/v1/apollo/users/search"},"x-aisa-source":{"content_hash":"sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a","converter":"reviewed-official-apollo-contact-bulk-body-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e","converter":"reviewed-official-apollo-query-arrays-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30","converter":"reviewed-official-apollo-object-bodies-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d","converter":"reviewed-official-apollo-bulk-update-request-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f","converter":"reviewed-apollo-nonempty-identity-client-guard@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752","converter":"reviewed-request-location-amendment@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","prior_source":{"content_hash":"sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"refresh_policy":"manual","review_period_days":30,"scope":"Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.","url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/api/v1/users/search","x-aisa-validation":"provider"}},"/apis/v1/brave/chat/completions":{"post":{"description":"\nUsage-based billing; Default request estimate: $0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_answer_apis_v1_brave_chat_completions","requestBody":{"content":{"application/json":{"schema":{"properties":{"country":{"default":"us","title":"Country","type":"string"},"enable_citations":{"default":false,"description":"Whether to include inline citation tags in the answer. Requires stream=true and is not supported in research mode.","title":"Enable Citations","type":"boolean"},"enable_entities":{"default":false,"description":"Whether to include inline entity tags in the answer. Requires stream=true and is not supported in research mode.","title":"Enable Entities","type":"boolean"},"enable_research":{"default":false,"description":"Whether to answer with iterative deep research instead of a single search. Requires stream=true.","title":"Enable Research","type":"boolean"},"language":{"default":"en","title":"Language","type":"string"},"max_completion_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Completion Tokens"},"messages":{"description":"The conversation so far. Exactly one user message is supported, e.g. [{"role": "user", "content": "Explain quantum computing"}].","items":{"properties":{"content":{"title":"Content","type":"string"},"role":{"const":"user","default":"user","enum":["user"],"title":"Role","type":"string"}},"required":["content"],"title":"UserMessage","type":"object"},"maxItems":1,"minItems":1,"title":"Messages","type":"array"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"description":"Accepted for OpenAI SDK compatibility and currently ignored: the pairs are not stored or returned.","title":"Metadata"},"model":{"default":"brave-pro","description":"Model ID used to generate the response.","enum":["brave-pro","brave"],"title":"Model","type":"string"},"research_allow_thinking":{"default":true,"description":"Accepted for compatibility. Ignored by the mixer engine behind this API, which always runs research with extended thinking off.","title":"Research Allow Thinking","type":"boolean"},"research_maximum_number_of_iterations":{"default":4,"description":"Maximum number of research iterations.","maximum":5,"minimum":1,"title":"Research Maximum Number Of Iterations","type":"integer"},"research_maximum_number_of_queries":{"default":20,"description":"Maximum number of search queries research mode may issue in total.","maximum":50,"minimum":1,"title":"Research Maximum Number Of Queries","type":"integer"},"research_maximum_number_of_results_per_query":{"default":30,"description":"Maximum number of search results to consider per research query.","maximum":60,"minimum":1,"title":"Research Maximum Number Of Results Per Query","type":"integer"},"research_maximum_number_of_seconds":{"default":180,"description":"Time budget for research, in seconds.","maximum":300,"minimum":1,"title":"Research Maximum Number Of Seconds","type":"integer"},"research_maximum_number_of_tokens_per_query":{"default":8192,"description":"Maximum number of tokens to gather per research query.","maximum":16384,"minimum":1024,"title":"Research Maximum Number Of Tokens Per Query","type":"integer"},"safesearch":{"default":"moderate","title":"Safesearch","type":"string"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Accepted for OpenAI SDK compatibility and currently ignored: answers are not reproducible.","title":"Seed"},"stream":{"default":true,"title":"Stream","type":"boolean"},"web_search_options":{"anyOf":[{"properties":{"search_context_size":{"anyOf":[{"enum":["low","medium","high"],"type":"string"},{"type":"null"}],"title":"Search Context Size"},"user_location":{"anyOf":[{"properties":{"approximate":{"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},"title":"ApproximateUserLocation","type":"object"},"type":{"const":"approximate","default":"approximate","enum":["approximate"],"title":"Type","type":"string"}},"required":["approximate"],"title":"UserLocation","type":"object"},{"type":"null"}]}},"title":"WebSearchOptions","type":"object"},{"type":"null"}]}},"required":["messages"],"title":"OpenAIChatRequest","type":"object"}}},"description":"","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_OpenAIChatResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Answers","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-answer","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-answer/any_brave_answer_apis_v1_brave_chat_completions","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.012,"estimate_source":"profile_seed","evidence_source":"response_header"},"x-aisa-provider":"brave-answer","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-answer","x-aisa-response-source":{"content_hash":"sha256:34dcfb4ef04155e184fab117848902578f062d776be9d753306c8c5df9ee2c14","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a6c71bc04a9","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c389345e3de7"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_answer_apis_v1_brave_chat_completions","path":"/apis/v1/brave/chat/completions"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/chat/completions","x-aisa-validation":"provider"}},"/apis/v1/brave/images/search":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_search_apis_v1_brave_images_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"offset parameter. Raise count to get more results.offset parameter. Raise count to get more results.ALL for worldwide.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries and ALL for worldwide."}},{"deprecated":false,"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","in":"query","name":"q","required":true,"schema":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"Q","type":"string"}},{"deprecated":false,"description":"\n
","examples":{"1":{"value":"off"},"2":{"value":"strict"}},"in":"query","name":"safesearch","required":false,"schema":{"allOf":[{"enum":["off","strict"],"title":"SafeSearch","type":"string"},{"default":"strict"}],"description":"\n
","examples":["off","strict"],"title":"Safe search"}},{"deprecated":false,"description":"The search language preference. The 2 or more character language code for which the search results are provided.","in":"query","name":"search_lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."}},{"deprecated":false,"description":"Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"spellcheck","required":false,"schema":{"default":true,"description":"Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_ImageSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Image Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_images_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:769418121d23b46db1c0dd197023994a20fb7067169165885ad745fbb6f6b1b3","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"fedeb511cc04"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_images_search","path":"/apis/v1/brave/images/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/images/search","x-aisa-validation":"provider"}},"/apis/v1/brave/llm/context":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_any_brave_search_apis_v1_brave_llm_context","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The generic name of the client city","examples":{"City in USA":{"value":"Ann Arbor"}},"in":"header","name":"x-loc-city","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The generic name of the client city","title":"X-Loc-City"}},{"deprecated":false,"description":"The two letter country code for the client’s country. For a list of country codes, see ISO 3166-1 alpha-2","examples":{"Country alpha-2 code":{"value":"US"}},"in":"header","name":"x-loc-country","required":false,"schema":{"anyOf":[{"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","YE","YT","ZA","ZM","ZW"],"title":"Country","type":"string"},{"type":"null"}],"description":"The two letter country code for the client’s country. For a list of country codes, see ISO 3166-1 alpha-2","title":"X-Loc-Country"}},{"deprecated":false,"description":"The latitude of the client’s geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.","examples":{"None":{}},"in":"header","name":"x-loc-lat","required":false,"schema":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"description":"The latitude of the client’s geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.","title":"X-Loc-Lat"}},{"deprecated":false,"description":"The longitude of the client’s geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.","examples":{"None":{}},"in":"header","name":"x-loc-long","required":false,"schema":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"description":"The longitude of the client’s geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.","title":"X-Loc-Long"}},{"deprecated":false,"description":"The client’s postal code","examples":{"Postal code in Ann Harbor, Michigan, US":{"value":"48105"}},"in":"header","name":"x-loc-postal-code","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The client’s postal code","title":"X-Loc-Postal-Code"}},{"deprecated":false,"description":"A code which could be up to three characters, that represent the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","examples":{"Michigan State/Region code in USA":{"value":"MI"}},"in":"header","name":"x-loc-state","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A code which could be up to three characters, that represent the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","title":"X-Loc-State"}},{"deprecated":false,"description":"The name of the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","examples":{"Michigan generic state name in USA":{"value":"Michigan"}},"in":"header","name":"x-loc-state-name","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","title":"X-Loc-State-Name"}},{"deprecated":false,"description":"The mode to use to determine the threshold for including content in context.","in":"query","name":"context_threshold_mode","required":false,"schema":{"anyOf":[{"enum":["disabled","strict","lenient","balanced"],"title":"SummarizerContextThresholdMode","type":"string"},{"type":"null"}],"description":"The mode to use to determine the threshold for including content in context.","title":"Context Threshold Mode"}},{"deprecated":false,"description":"The maximum number of search results considered to select the LLM context data. The default is 20 and the maximum is 50.","in":"query","name":"count","required":false,"schema":{"default":20,"description":"The maximum number of search results considered to select the LLM context data. The default is 20 and the maximum is 50.","maximum":50,"minimum":1,"title":"Count","type":"integer"}},{"deprecated":false,"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries."}},{"deprecated":false,"description":"Whether to enable local recall. Not setting this value means auto-detect: local recall is used if a location is provided (X-Loc-Lat with X-Loc-Long, or X-Loc-City).","in":"query","name":"enable_local","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to enable local recall. Not setting this value means auto-detect: local recall is used if a location is provided (X-Loc-Lat with X-Loc-Long, or X-Loc-City).","title":"Enable Local"}},{"deprecated":false,"description":"Enable source metadata enrichment (site_name, favicon, thumbnail, description, fetched_content_timestamp) in the sources attribute of the response.","in":"query","name":"enable_source_metadata","required":false,"schema":{"default":false,"description":"Enable source metadata enrichment (site_name, favicon, thumbnail, description, fetched_content_timestamp) in the sources attribute of the response.","title":"Enable Source Metadata","type":"boolean"}},{"deprecated":false,"description":"\n
","examples":{"0":{"value":""},"1":{"value":"pm"},"2":{"value":"2022-04-01to2022-07-30"}},"in":"query","name":"freshness","required":false,"schema":{"default":"","description":"2022-04-01to2022-07-30.\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"}},{"deprecated":false,"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","examples":{"Prioritizes domains popular with the Hacker News":{"value":"https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/hacker_news.goggle"},"Social media blocker":{"value":"! name: Social Networks\n! description: Removes social networks\n! public: true\n! author: Average Joe\n! avatar: #de0320\n$discard,site=facebook.com\n$discard,site=x.com\n$discard,site=instagram.com"}},"in":"query","name":"goggles","required":false,"schema":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"}},{"deprecated":false,"description":"Maximum number of different snippets (or chunks of text) to include in LLM context. The default is 2022-04-01to2022-07-30.50 and maximum is 256.","in":"query","name":"maximum_number_of_snippets","required":false,"schema":{"default":50,"description":"Maximum number of different snippets (or chunks of text) to include in LLM context. The default is 50 and maximum is 256.","maximum":256,"minimum":1,"title":"Maximum Number Of Snippets","type":"integer"}},{"deprecated":false,"description":"Maximum number of snippets to include per URL. The default is 50 and maximum is 100.","in":"query","name":"maximum_number_of_snippets_per_url","required":false,"schema":{"default":50,"description":"Maximum number of snippets to include per URL. The default is 50 and maximum is 100.","maximum":100,"minimum":1,"title":"Maximum Number Of Snippets Per Url","type":"integer"}},{"deprecated":false,"description":"Approximate maximum number of tokens to include in context. The default is 8192 and maximum is 32768.","in":"query","name":"maximum_number_of_tokens","required":false,"schema":{"default":8192,"description":"Approximate maximum number of tokens to include in context. The default is 8192 and maximum is 32768.","maximum":32768,"minimum":1024,"title":"Maximum Number Of Tokens","type":"integer"}},{"deprecated":false,"description":"Maximum number of tokens to include per URL. The default is 4096 and maximum is 8192.","in":"query","name":"maximum_number_of_tokens_per_url","required":false,"schema":{"default":4096,"description":"Maximum number of tokens to include per URL. The default is 4096 and maximum is 8192.","maximum":8192,"minimum":512,"title":"Maximum Number Of Tokens Per Url","type":"integer"}},{"deprecated":false,"description":"Maximum number of different URLs to include in LLM context.","in":"query","name":"maximum_number_of_urls","required":false,"schema":{"default":20,"description":"Maximum number of different URLs to include in LLM context.","maximum":50,"minimum":1,"title":"Maximum Number Of Urls","type":"integer"}},{"deprecated":false,"description":"The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query.","in":"query","name":"q","required":true,"schema":{"description":"The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query.","maxLength":600,"minLength":1,"title":"Q","type":"string"}},{"deprecated":false,"description":"\n
\nstrict.\n
\nstrict.YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The generic name of the client city","examples":{"City in USA":{"value":"Ann Arbor"}},"in":"header","name":"x-loc-city","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The generic name of the client city","title":"X-Loc-City"}},{"deprecated":false,"description":"The two letter country code for the client’s country. For a list of country codes, see ISO 3166-1 alpha-2","examples":{"Country alpha-2 code":{"value":"US"}},"in":"header","name":"x-loc-country","required":false,"schema":{"anyOf":[{"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","YE","YT","ZA","ZM","ZW"],"title":"Country","type":"string"},{"type":"null"}],"description":"The two letter country code for the client’s country. For a list of country codes, see ISO 3166-1 alpha-2","title":"X-Loc-Country"}},{"deprecated":false,"description":"The latitude of the client’s geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.","examples":{"None":{}},"in":"header","name":"x-loc-lat","required":false,"schema":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"description":"The latitude of the client’s geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.","title":"X-Loc-Lat"}},{"deprecated":false,"description":"The longitude of the client’s geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.","examples":{"None":{}},"in":"header","name":"x-loc-long","required":false,"schema":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"description":"The longitude of the client’s geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.","title":"X-Loc-Long"}},{"deprecated":false,"description":"The client’s postal code","examples":{"Postal code in Ann Harbor, Michigan, US":{"value":"48105"}},"in":"header","name":"x-loc-postal-code","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The client’s postal code","title":"X-Loc-Postal-Code"}},{"deprecated":false,"description":"A code which could be up to three characters, that represent the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","examples":{"Michigan State/Region code in USA":{"value":"MI"}},"in":"header","name":"x-loc-state","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A code which could be up to three characters, that represent the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","title":"X-Loc-State"}},{"deprecated":false,"description":"The name of the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","examples":{"Michigan generic state name in USA":{"value":"Michigan"}},"in":"header","name":"x-loc-state-name","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.","title":"X-Loc-State-Name"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"context_threshold_mode":{"anyOf":[{"enum":["disabled","strict","lenient","balanced"],"title":"SummarizerContextThresholdMode","type":"string"},{"type":"null"}],"description":"The mode to use to determine the threshold for including content in context."},"count":{"default":20,"description":"The maximum number of search results considered to select the LLM context data. The default is 20 and the maximum is 50.","maximum":50,"minimum":1,"title":"Count","type":"integer"},"country":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries."},"enable_local":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether to enable local recall. Not setting this value means auto-detect: local recall is used if a location is provided (X-Loc-Lat with X-Loc-Long, or X-Loc-City).","title":"Enable Local"},"enable_source_metadata":{"default":false,"description":"Enable source metadata enrichment (site_name, favicon, thumbnail, description, fetched_content_timestamp) in the sources attribute of the response.","title":"Enable Source Metadata","type":"boolean"},"freshness":{"default":"","description":"\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"goggles":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"},"maximum_number_of_snippets":{"default":50,"description":"Maximum number of different snippets (or chunks of text) to include in LLM context. The default is 2022-04-01to2022-07-30.50 and maximum is 256.","maximum":256,"minimum":1,"title":"Maximum Number Of Snippets","type":"integer"},"maximum_number_of_snippets_per_url":{"default":50,"description":"Maximum number of snippets to include per URL. The default is 50 and maximum is 100.","maximum":100,"minimum":1,"title":"Maximum Number Of Snippets Per Url","type":"integer"},"maximum_number_of_tokens":{"default":8192,"description":"Approximate maximum number of tokens to include in context. The default is 8192 and maximum is 32768.","maximum":32768,"minimum":1024,"title":"Maximum Number Of Tokens","type":"integer"},"maximum_number_of_tokens_per_url":{"default":4096,"description":"Maximum number of tokens to include per URL. The default is 4096 and maximum is 8192.","maximum":8192,"minimum":512,"title":"Maximum Number Of Tokens Per Url","type":"integer"},"maximum_number_of_urls":{"default":20,"description":"Maximum number of different URLs to include in LLM context.","maximum":50,"minimum":1,"title":"Maximum Number Of Urls","type":"integer"},"q":{"description":"The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query.","maxLength":600,"minLength":1,"title":"Q","type":"string"},"safesearch":{"anyOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"type":"null"}],"description":"\n
\nstrict.YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"A list of unique identifiers for the location. The ids are valid only for 8 hours.","in":"query","name":"ids","required":true,"schema":{"description":"A list of unique identifiers for the location. The ids are valid only for 8 hours.","items":{"type":"string"},"maxItems":20,"minItems":1,"title":"Ids","type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_LocalDescriptionsSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"POI Descriptions","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_local_descriptions","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:aa4248729ebdc0a3780c81c6cd12b50533a93913b3ab3abb83c8b8273d2b7fed","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"36cf6aee276b"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_local_descriptions","path":"/apis/v1/brave/local/descriptions"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/local/descriptions","x-aisa-validation":"provider"}},"/apis/v1/brave/local/place_search":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_search_apis_v1_brave_local_place_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"Number of results to return. The maximum is 100.","in":"query","name":"count","required":false,"schema":{"default":20,"description":"Number of results to return. The maximum is 100.","maximum":100,"minimum":1,"title":"Count","type":"integer"}},{"deprecated":false,"description":"Two-letter country code (ISO 3166-1 alpha-2) to scope the search.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"Two-letter country code (ISO 3166-1 alpha-2) to scope the search."}},{"deprecated":false,"description":"Optional geolocation of the user in the format <latitude>x<longitude>. Used to calculate distance values in results.","in":"query","name":"geoloc","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional geolocation of the user in the format <latitude>x<longitude>. Used to calculate distance values in results.","title":"Geoloc"}},{"deprecated":false,"description":"Latitude of the geographical coordinates.","in":"query","name":"latitude","required":false,"schema":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"description":"Latitude of the geographical coordinates.","title":"Latitude"}},{"deprecated":false,"description":"latitude and longitude parameters.\n
","in":"query","name":"location","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"<city> <state> <country name>, ie. san francisco ca united states<city> <country name>, ie. tokyo japannueva york instead of new york works, but using English or the most popular language on the target city should work the bestlatitude and longitude parameters.\n
","title":"Location"}},{"deprecated":false,"description":"Longitude of the geographical coordinates.","in":"query","name":"longitude","required":false,"schema":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"description":"Longitude of the geographical coordinates.","title":"Longitude"}},{"deprecated":false,"description":"Query string to search for points of interest in an area. If no <city> <state> <country name>, ie. san francisco ca united states<city> <country name>, ie. tokyo japannueva york instead of new york works, but using English or the most popular language on the target city should work the bestq is provided, the endpoint will return general points of interest in the given area.","in":"query","name":"q","required":false,"schema":{"default":"","description":"Query string to search for points of interest in an area. If no q is provided, the endpoint will return general points of interest in the given area.","title":"Q","type":"string"}},{"deprecated":false,"description":"Search radius bias around the given coordinates, in meters. NOTE: This is not strictly the radius of the search (nor the resulting radius of the results), but rather a bias towards results that are closer to the given coordinates. Search is performed globally if no radius is provided.","in":"query","name":"radius","required":false,"schema":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"description":"Search radius bias around the given coordinates, in meters. NOTE: This is not strictly the radius of the search (nor the resulting radius of the results), but rather a bias towards results that are closer to the given coordinates. Search is performed globally if no radius is provided.","title":"Radius"}},{"deprecated":false,"description":"Safe search level for the query results.","in":"query","name":"safesearch","required":false,"schema":{"allOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"default":"strict"}],"description":"Safe search level for the query results."}},{"deprecated":false,"description":"Language for the search results.","in":"query","name":"search_lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"Language for the search results."}},{"deprecated":false,"description":"Whether to apply spellcheck before executing the search.","in":"query","name":"spellcheck","required":false,"schema":{"default":true,"description":"Whether to apply spellcheck before executing the search.","title":"Spellcheck","type":"boolean"}},{"deprecated":false,"description":"User interface language for the response. Usually <language>-<region>.","in":"query","name":"ui_lang","required":false,"schema":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language for the response. Usually <language>-<region>."}},{"deprecated":false,"description":"Units of measurement for distance values: metric is kilometres, imperial is miles.","in":"query","name":"units","required":false,"schema":{"allOf":[{"enum":["imperial","metric"],"title":"MeasurementUnit","type":"string"},{"default":"metric"}],"description":"Units of measurement for distance values: metric is kilometres, imperial is miles."}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_LocalPlaceSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Place Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_local_place_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:530855bdd20c7dbcc5b6cb508d87836ad778965f55549fc5ec5ad86dc57ef922","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"ccd8ead2aa11"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_local_place_search","path":"/apis/v1/brave/local/place_search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/local/place_search","x-aisa-validation":"provider"}},"/apis/v1/brave/local/pois":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_search_apis_v1_brave_local_pois","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The latitude of the client’s geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.","in":"header","name":"x-loc-lat","required":false,"schema":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"description":"The latitude of the client’s geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.","title":"X-Loc-Lat"}},{"deprecated":false,"description":"The longitude of the client’s geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.","in":"header","name":"x-loc-long","required":false,"schema":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"description":"The longitude of the client’s geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.","title":"X-Loc-Long"}},{"deprecated":false,"description":"A list of unique identifiers for the location. The ids are valid only for 8 hours.","in":"query","name":"ids","required":true,"schema":{"description":"A list of unique identifiers for the location. The ids are valid only for 8 hours.","items":{"type":"string"},"maxItems":20,"minItems":1,"title":"Ids","type":"array"}},{"deprecated":false,"description":"The search language preference. The 2 or more character language code for which the search results are provided.","in":"query","name":"search_lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."}},{"deprecated":false,"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","in":"query","name":"ui_lang","required":false,"schema":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}},{"deprecated":false,"description":"\n
","examples":{"Imperial units":{"value":"imperial"},"Metric units":{"value":"metric"}},"in":"query","name":"units","required":false,"schema":{"anyOf":[{"enum":["imperial","metric"],"title":"MeasurementUnit","type":"string"},{"type":"null"}],"description":"\n
","title":"Units"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_LocalPoiSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Local POIs","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent","X-Loc-Lat","X-Loc-Long"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_local_pois","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:403c115259e585766a9eea85b2b08a9df16efd305c1d54c7084ef0e37bb80558","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"f894a5d8bbb3"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_local_pois","path":"/apis/v1/brave/local/pois"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/local/pois","x-aisa-validation":"provider"}},"/apis/v1/brave/news/search":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_any_brave_search_apis_v1_brave_news_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","in":"query","name":"count","required":false,"schema":{"default":20,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","maximum":50,"minimum":1,"title":"Count","type":"integer"}},{"deprecated":false,"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide."}},{"deprecated":false,"description":"A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts.","examples":{"Exclude extra snippets":{"value":false},"Include extra snippets":{"value":true}},"in":"query","name":"extra_snippets","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts.","title":"Extra Snippets"}},{"deprecated":false,"description":"\n
","examples":{"0":{"value":""},"1":{"value":"pm"},"2":{"value":"2022-04-01to2022-07-30"}},"in":"query","name":"freshness","required":false,"schema":{"default":"","description":"2022-04-01to2022-07-30.\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"}},{"deprecated":false,"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","examples":{"":{"value":""},"Prioritizes domains popular with the Hacker News":{"value":"https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/hacker_news.goggle"},"Social media blocker":{"value":"! name: Social Networks\n! description: Removes social networks\n! public: true\n! author: Average Joe\n! avatar: #de0320\n$discard,site=facebook.com\n$discard,site=x.com\n$discard,site=instagram.com"}},"in":"query","name":"goggles","required":false,"schema":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"}},{"deprecated":false,"description":"Include fetch metadata.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"include_fetch_metadata","required":false,"schema":{"default":false,"description":"Include fetch metadata.","examples":[true,false],"title":"Include Fetch Metadata","type":"boolean"}},{"deprecated":false,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","maximum":9,"minimum":0,"title":"Offset","type":"integer"}},{"deprecated":false,"description":"Whether to apply search operators.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"operators","required":false,"schema":{"default":true,"description":"Whether to apply search operators.","examples":[true,false],"title":"Operators","type":"boolean"}},{"deprecated":false,"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","in":"query","name":"q","required":true,"schema":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"The user's search query term.","type":"string"}},{"deprecated":false,"description":"2022-04-01to2022-07-30.\n
","examples":{"1":{"value":"off"},"2":{"value":"moderate"},"3":{"value":"strict"}},"in":"query","name":"safesearch","required":false,"schema":{"allOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"default":"strict"}],"description":"\n
","examples":["off","moderate","strict"],"title":"Safe search"}},{"deprecated":false,"description":"The search language preference. The 2 or more character language code for which the search results are provided.","in":"query","name":"search_lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."}},{"deprecated":false,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"spellcheck","required":false,"schema":{"default":true,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"}},{"deprecated":false,"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","in":"query","name":"ui_lang","required":false,"schema":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_NewsSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"News Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET","POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/get_any_brave_search_apis_v1_brave_news_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:1d79f6425835220b35c92acb6542874ca6664f078c5180a3a4b0544bd2d94308","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"51ebd5e918c8"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_news_search","path":"/apis/v1/brave/news/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/news/search","x-aisa-validation":"provider"},"post":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_any_brave_search_apis_v1_brave_news_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"count":{"default":20,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","maximum":50,"minimum":1,"title":"Count","type":"integer"},"country":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide."},"extra_snippets":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts.","title":"Extra Snippets"},"freshness":{"default":"","description":"\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"goggles":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"},"include_fetch_metadata":{"default":false,"description":"Include fetch metadata.","examples":[true,false],"title":"Include Fetch Metadata","type":"boolean"},"offset":{"default":0,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","maximum":9,"minimum":0,"title":"Offset","type":"integer"},"operators":{"default":true,"description":"Whether to apply search operators.","examples":[true,false],"title":"Operators","type":"boolean"},"q":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"The user's search query term.","type":"string"},"safesearch":{"allOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"default":"strict"}],"description":"2022-04-01to2022-07-30.\n
","examples":["off","moderate","strict"],"title":"Safe search"},"search_lang":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."},"spellcheck":{"default":true,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"},"ui_lang":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}},"required":["q"],"title":"NewsSearchParameters","type":"object"}}},"description":"","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_NewsSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"News Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET","POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/post_any_brave_search_apis_v1_brave_news_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:1d79f6425835220b35c92acb6542874ca6664f078c5180a3a4b0544bd2d94308","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"51ebd5e918c8"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_news_search","path":"/apis/v1/brave/news/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/news/search","x-aisa-validation":"provider"}},"/apis/v1/brave/spellcheck/search":{"get":{"description":"\nPublished reference price: $0.0005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_search_apis_v1_brave_spellcheck_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The spell check country, where potentially the results could come from. The country string is limited to 2 character country codes of supported countries. This is a just a hint for calculating spellcheck responses.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The spell check country, where potentially the results could come from. The country string is limited to 2 character country codes of supported countries. This is a just a hint for calculating spellcheck responses."}},{"deprecated":false,"description":"The spell check language preference, where potentially the results could come from. The 2 or more character language code for which the spell check search results are provided. This is a just a hint for calculating spell check responses.","in":"query","name":"lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The spell check language preference, where potentially the results could come from. The 2 or more character language code for which the spell check search results are provided. This is a just a hint for calculating spell check responses."}},{"deprecated":false,"description":"The phrase to be spell checked. Query can not be empty. Maximum of 400 characters and 50 words in the query.","in":"query","name":"q","required":true,"schema":{"description":"The phrase to be spell checked. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"Q","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_SpellCheckSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Spell Check","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_spellcheck_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:1911dd76363df3dc17ac3ba2cbcdc86f178effe82c4cc540ef76c002fc2fa943","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"1ca093c7eca8"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_spellcheck_search","path":"/apis/v1/brave/spellcheck/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/spellcheck/search","x-aisa-validation":"provider"}},"/apis/v1/brave/suggest/search":{"get":{"description":"\nPublished reference price: $0.0005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_search_apis_v1_brave_suggest_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The number of suggestion search results returned in response. The actual number of results delivered may be less than requested. Minimum is 1, maximum is 20. The default is 5.","in":"query","name":"count","required":false,"schema":{"default":5,"description":"The number of suggestion search results returned in response. The actual number of results delivered may be less than requested. Minimum is 1, maximum is 20. The default is 5.","maximum":20,"minimum":1,"title":"Count","type":"integer"}},{"deprecated":false,"description":"The suggest search query country, where potentially the results could come from. The country string is limited to 2 character country codes of supported countries. This is a just a hint for calculating suggest responses.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The suggest search query country, where potentially the results could come from. The country string is limited to 2 character country codes of supported countries. This is a just a hint for calculating suggest responses."}},{"deprecated":false,"description":"The suggest search language preference, where potentially the results could come from. The 2 or more character language code for which the suggest search results are provided. This is a just a hint for calculating suggest responses.","in":"query","name":"lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The suggest search language preference, where potentially the results could come from. The 2 or more character language code for which the suggest search results are provided. This is a just a hint for calculating suggest responses."}},{"deprecated":false,"description":"The user’s suggest search query term. Query can not be empty. The max query length is 400 characters, and the word limit is 50 words.","in":"query","name":"q","required":true,"schema":{"description":"The user’s suggest search query term. Query can not be empty. The max query length is 400 characters, and the word limit is 50 words.","maxLength":400,"minLength":1,"title":"The user's suggest search query term.","type":"string"}},{"deprecated":false,"description":"Whether to enhance suggestions with rich results. This requires a paid autosuggest subscription.","examples":{"Exclude rich suggestions":{"value":false},"Include rich suggestions":{"value":true}},"in":"query","name":"rich","required":false,"schema":{"default":false,"description":"Whether to enhance suggestions with rich results. This requires a paid autosuggest subscription.","title":"Rich","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_SuggestSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Suggest","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_suggest_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:90317eb223a04f50a85434038920232a71cff07b121f71c4de6ded04b1f1916d","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"9b020e68bb70"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_suggest_search","path":"/apis/v1/brave/suggest/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/suggest/search","x-aisa-validation":"provider"}},"/apis/v1/brave/videos/search":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_any_brave_search_apis_v1_brave_videos_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","in":"query","name":"count","required":false,"schema":{"default":20,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","maximum":50,"minimum":1,"title":"Count","type":"integer"}},{"deprecated":false,"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide.","in":"query","name":"country","required":false,"schema":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide."}},{"deprecated":false,"description":"\n
","examples":{"0":{"value":""},"1":{"value":"pm"},"2":{"value":"2022-04-01to2022-07-30"}},"in":"query","name":"freshness","required":false,"schema":{"default":"","description":"2022-04-01to2022-07-30.\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"}},{"deprecated":false,"description":"Include fetch metadata.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"include_fetch_metadata","required":false,"schema":{"default":false,"description":"Include fetch metadata.","examples":[true,false],"title":"Include Fetch Metadata","type":"boolean"}},{"deprecated":false,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","maximum":9,"minimum":0,"title":"Offset","type":"integer"}},{"deprecated":false,"description":"Whether to apply search operators.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"operators","required":false,"schema":{"default":true,"description":"Whether to apply search operators.","examples":[true,false],"title":"Operators","type":"boolean"}},{"deprecated":false,"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","in":"query","name":"q","required":true,"schema":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"Q","type":"string"}},{"deprecated":false,"description":"2022-04-01to2022-07-30.\n
","examples":{"1":{"value":"off"},"2":{"value":"moderate"},"3":{"value":"strict"}},"in":"query","name":"safesearch","required":false,"schema":{"allOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"default":"moderate"}],"description":"\n
","examples":["off","moderate","strict"],"title":"Safe search"}},{"deprecated":false,"description":"The search language preference. The 2 or more character language code for which the search results are provided.","in":"query","name":"search_lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."}},{"deprecated":false,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"spellcheck","required":false,"schema":{"default":true,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"}},{"deprecated":false,"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","in":"query","name":"ui_lang","required":false,"schema":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_VideoSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Video Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET","POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/get_any_brave_search_apis_v1_brave_videos_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:ec5084e4995913b7cb7f1458f696455f0938e87e0d6f008768544de7026977fa","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a0b4a51fac84"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_videos_search","path":"/apis/v1/brave/videos/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/videos/search","x-aisa-validation":"provider"},"post":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_any_brave_search_apis_v1_brave_videos_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"count":{"default":20,"description":"The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results.","maximum":50,"minimum":1,"title":"Count","type":"integer"},"country":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"title":"SearchCountry","type":"string"},{"default":"US"}],"description":"The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide."},"freshness":{"default":"","description":"\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"include_fetch_metadata":{"default":false,"description":"Include fetch metadata.","examples":[true,false],"title":"Include Fetch Metadata","type":"boolean"},"offset":{"default":0,"description":"The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages.","maximum":9,"minimum":0,"title":"Offset","type":"integer"},"operators":{"default":true,"description":"Whether to apply search operators.","examples":[true,false],"title":"Operators","type":"boolean"},"q":{"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.","maxLength":400,"minLength":1,"title":"Q","type":"string"},"safesearch":{"allOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"default":"moderate"}],"description":"2022-04-01to2022-07-30.\n
","examples":["off","moderate","strict"],"title":"Safe search"},"search_lang":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."},"spellcheck":{"default":true,"description":"Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"},"ui_lang":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110."}},"required":["q"],"title":"VideoSearchParameters","type":"object"}}},"description":"","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_VideoSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Video Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET","POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/post_any_brave_search_apis_v1_brave_videos_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:ec5084e4995913b7cb7f1458f696455f0938e87e0d6f008768544de7026977fa","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a0b4a51fac84"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_videos_search","path":"/apis/v1/brave/videos/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/videos/search","x-aisa-validation":"provider"}},"/apis/v1/brave/web/rich":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"any_brave_search_apis_v1_brave_web_rich","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The callback key to use for the rich header","in":"query","name":"callback_key","required":true,"schema":{"description":"The callback key to use for the rich header","title":"Callback Key","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_RichHeaderResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Rich Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/any_brave_search_apis_v1_brave_web_rich","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:a213ff42dbce1dddd4ef7200de71e109444e8ea9ff3855377481219c8f6386b2","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"f19ad992ccec"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_web_rich","path":"/apis/v1/brave/web/rich"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/web/rich","x-aisa-validation":"provider"}},"/apis/v1/brave/web/search":{"get":{"description":"\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"get_any_brave_search_apis_v1_brave_web_search","parameters":[{"deprecated":false,"description":"The default supported media type is application/json.","examples":{"0":{"value":"application/json"}},"in":"header","name":"accept","required":false,"schema":{"allOf":[{"enum":["application/json","*/*"],"title":"Accept","type":"string"},{"default":"application/json"}],"description":"The default supported media type is application/json.","examples":["application/json"],"title":"Media type"}},{"deprecated":false,"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The generic name of the client city.","examples":{"City in USA":{"value":"San Francisco"}},"in":"header","name":"x-loc-city","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The generic name of the client city.","title":"City"}},{"deprecated":false,"description":"Search plan.Search plan.\n
","examples":{"0":{"value":""},"1":{"value":"pm"},"2":{"value":"2022-04-01to2022-07-30"}},"in":"query","name":"freshness","required":false,"schema":{"default":"","description":"2022-04-01to2022-07-30.\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"}},{"deprecated":false,"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","examples":{"":{"value":""},"Prioritizes domains popular with the Hacker News":{"value":"https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/hacker_news.goggle"},"Social media blocker":{"value":"! name: Social Networks\n! description: Removes social networks\n! public: true\n! author: Average Joe\n! avatar: #de0320\n\n$discard,site=facebook.com\n$discard,site=x.com\n$discard,site=instagram.com"}},"in":"query","name":"goggles","required":false,"schema":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"}},{"deprecated":true,"description":"Goggles act as a custom re-ranking on top of Brave’s search index. For more details, refer to the Goggles repository. This parameter is deprecated. Please use the goggles parameter.","examples":{"":{"value":""},"Prioritizes domains popular with the Hacker News":{"value":"https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/hacker_news.goggle"}},"in":"query","name":"goggles_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. For more details, refer to the Goggles repository. This parameter is deprecated. Please use the goggles parameter.","title":"Goggles id"}},{"deprecated":false,"description":"Include fetch metadata.","examples":{"1":{"value":false},"2":{"value":true}},"in":"query","name":"include_fetch_metadata","required":false,"schema":{"default":false,"description":"Include fetch metadata.","examples":[false,true],"title":"Include Fetch Metadata","type":"boolean"}},{"deprecated":false,"description":"2022-04-01to2022-07-30.discussions, faq, infobox, news, query, summarizer, videos, web, locations.discussions, faq, infobox, news, query, summarizer, videos, web, locations.\n
","examples":{"1":{"value":"off"},"2":{"value":"moderate"},"3":{"value":"strict"}},"in":"query","name":"safesearch","required":false,"schema":{"allOf":[{"enum":["off","moderate","strict"],"title":"SafeSearch","type":"string"},{"default":"moderate"}],"description":"\n
","examples":["off","moderate","strict"],"title":"Safe search"}},{"deprecated":false,"description":"The 2 or more character language code for which the search results are provided.","in":"query","name":"search_lang","required":false,"schema":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The 2 or more character language code for which the search results are provided.","title":"Search language"}},{"deprecated":false,"description":"Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"spellcheck","required":false,"schema":{"default":true,"description":"Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"}},{"deprecated":false,"description":"This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"summary","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.","examples":[true,false],"title":"Summary"}},{"deprecated":false,"description":"Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).","examples":{"1":{"value":true},"2":{"value":false}},"in":"query","name":"text_decorations","required":false,"schema":{"default":true,"description":"Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).","examples":[true,false],"title":"Text decorations","type":"boolean"}},{"deprecated":false,"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","in":"query","name":"ui_lang","required":false,"schema":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","title":"User interface language"}},{"deprecated":false,"description":"\n
","examples":{"1":{"value":"metric"},"2":{"value":"imperial"}},"in":"query","name":"units","required":false,"schema":{"anyOf":[{"enum":["imperial","metric"],"title":"MeasurementUnit","type":"string"},{"type":"null"}],"description":"\n
","examples":["metric","imperial"],"title":"Units"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_WebSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Web Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent","X-Loc-City","X-Loc-Country","X-Loc-Lat","X-Loc-Long","X-Loc-Postal-Code","X-Loc-State","X-Loc-State-Name","X-Loc-Timezone"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET","POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/get_any_brave_search_apis_v1_brave_web_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:07877ca74d5edf9bc8268a9a4a70022e645e3d4c1e77ded52c9f503ee1dee2bd","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6fc06760dbce"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_web_search","path":"/apis/v1/brave/web/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/web/search","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/brave/web/search?q=brave+search' \\\n --header 'Authorization: Bearer YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","in":"header","name":"api-version","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning.","title":"API version"}},{"deprecated":false,"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","in":"header","name":"cache-control","required":false,"schema":{"anyOf":[{"const":"no-cache","enum":["no-cache"],"title":"CacheControl","type":"string"},{"type":"null"}],"description":"Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.","title":"Cache control"}},{"deprecated":false,"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","examples":{"Android":{"description":"Android","value":"Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36"},"Windows":{"description":"Windows","value":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"},"iOS":{"description":"iOS","value":"Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1"},"macOS":{"description":"macOS","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36"}},"in":"header","name":"user-agent","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.","title":"User agent"}},{"deprecated":false,"description":"The generic name of the client city.","examples":{"City in USA":{"value":"San Francisco"}},"in":"header","name":"x-loc-city","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The generic name of the client city.","title":"City"}},{"deprecated":false,"description":"Search plan.\n
","examples":["","pm","2022-04-01to2022-07-30"],"title":"Freshness","type":"string"},"goggles":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the Goggles documentation. The parameter can be a single Goggle or a list of up to 3 Goggles.","title":"Goggles"},"goggles_id":{"anyOf":[{"type":"string"},{"type":"null"}],"deprecated":true,"description":"Goggles act as a custom re-ranking on top of Brave’s search index. For more details, refer to the Goggles repository. This parameter is deprecated. Please use the goggles parameter.","title":"Goggles id"},"include_fetch_metadata":{"default":false,"description":"Include fetch metadata.","examples":[false,true],"title":"Include Fetch Metadata","type":"boolean"},"offset":{"default":0,"description":"2022-04-01to2022-07-30.discussions, faq, infobox, news, query, summarizer, videos, web, locations.\n
","examples":["off","moderate","strict"],"title":"Safe search"},"search_lang":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"title":"Language","type":"string"},{"default":"en"}],"description":"The 2 or more character language code for which the search results are provided.","title":"Search language"},"spellcheck":{"default":true,"description":"Whether to spell check provided query. If the spell checker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model.","examples":[true,false],"title":"Spellcheck","type":"boolean"},"summary":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.","examples":[true,false],"title":"Summary"},"text_decorations":{"default":true,"description":"Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).","examples":[true,false],"title":"Text decorations","type":"boolean"},"ui_lang":{"allOf":[{"enum":["es-AR","en-AU","de-AT","nl-BE","fr-BE","pt-BR","en-CA","fr-CA","es-CL","da-DK","fi-FI","fr-FR","de-DE","el-GR","zh-HK","en-IN","en-ID","it-IT","ja-JP","ko-KR","en-MY","es-MX","nl-NL","en-NZ","no-NO","zh-CN","pl-PL","en-PH","ru-RU","en-ZA","es-ES","sv-SE","fr-CH","de-CH","zh-TW","tr-TR","en-GB","en-US","es-US"],"title":"MarketCodes","type":"string"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.","title":"User interface language"},"units":{"anyOf":[{"enum":["imperial","metric"],"title":"MeasurementUnit","type":"string"},{"type":"null"}],"description":"\n
","examples":["metric","imperial"],"title":"Units"}},"required":["q"],"title":"WebSearchParameters","type":"object"}}},"description":"","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response762Cca4421D2_WebSearchApiResponse"}}},"description":"Successful Response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Web Search","tags":["default"],"x-aisa-caller-headers":["Api-Version","Cache-Control","User-Agent","X-Loc-City","X-Loc-Country","X-Loc-Lat","X-Loc-Long","X-Loc-Postal-Code","X-Loc-State","X-Loc-State-Name","X-Loc-Timezone"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["GET","POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"brave-search","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/brave-search/post_any_brave_search_apis_v1_brave_web_search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.005,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"brave-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"brave-search","x-aisa-response-source":{"content_hash":"sha256:07877ca74d5edf9bc8268a9a4a70022e645e3d4c1e77ded52c9f503ee1dee2bd","kind":"upstream_success_contract","source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"}},"x-aisa-revision":{"customer_pricing_ref":"5a1e4970a8aa","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6fc06760dbce"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_brave_search_apis_v1_brave_web_search","path":"/apis/v1/brave/web/search"},"x-aisa-source":{"content_hash":"sha256:e581693aa967b6fab7c27a27b109366e901825881ad7548f3984bbc5619b914a","converter":"scripts/import_brave_reference.py@4","fetched_at":"2026-10-16T11:33:59.813162+00:00","kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:a28127338b1a641229c3afbb4225985e91539e9f038343db46915bbd72d1bb84","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"source_index_hash":"sha256:52c0cb183f49315a5ea590ab37a9fa11b5ba8ff14c7fd04609069c5553001997","source_pages":[{"content_hash":"sha256:52c109c10f836716e93dda8933134f98f045caf8c78e8cf0ce63a1fc0b754c4f","url":"https://api-dashboard.search.brave.com/api-reference/ai/answers/__data.json"},{"content_hash":"sha256:3b02fc8c617b493d74da1b98337c57e2c34101ce1a6f87add3b5c0f5faf525d8","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/get/__data.json"},{"content_hash":"sha256:35820dbc01fe3a57e7020d508a2fadf49fbec3e6ff3363ef7500959d093f55a5","url":"https://api-dashboard.search.brave.com/api-reference/ai/llm_context/post/__data.json"},{"content_hash":"sha256:ab4bc9c2042bb31c13bdc06d423c909ccde12916069f6ef1b069228f01db2a8d","url":"https://api-dashboard.search.brave.com/api-reference/images/image_search/__data.json"},{"content_hash":"sha256:3b1afa4e3f81f264d3f245b77ea5273d9a213d2b3de4b4d7dedc01894b37fc64","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/get/__data.json"},{"content_hash":"sha256:54e73cc6097e7df880dc42143933d9bc07f919e07b116625408bb032ef7d4cc5","url":"https://api-dashboard.search.brave.com/api-reference/news/news_search/post/__data.json"},{"content_hash":"sha256:85cd7a6d3f01850436d332cfc44a726210657f139c0cc80a47a9c74470766a9c","url":"https://api-dashboard.search.brave.com/api-reference/other/spell_check/__data.json"},{"content_hash":"sha256:5c4dbb20ea770ef2c97ba1c6c3775716bcd7d74d4d9bd87bd91e78116e6c769e","url":"https://api-dashboard.search.brave.com/api-reference/other/suggestions/__data.json"},{"content_hash":"sha256:ff221fa765497085ae7a4ce9752831b80c69af59990847057784ba50a68e405a","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/get/__data.json"},{"content_hash":"sha256:f5b0f5a02fcdc52cff7f1618beebced3e0341afbf4b31a2ae18b92f61d51ecec","url":"https://api-dashboard.search.brave.com/api-reference/videos/video_search/post/__data.json"},{"content_hash":"sha256:1a3811afefd39e19506a0a24e3b463307f219cc7c08db9348cab8807a70909fe","url":"https://api-dashboard.search.brave.com/api-reference/web/local_pois/__data.json"},{"content_hash":"sha256:389dee2acae3b6fb0fb516e7c7ec271a354fb511a616f68522d593c73109a87e","url":"https://api-dashboard.search.brave.com/api-reference/web/place_search/__data.json"},{"content_hash":"sha256:36d19685c3e9eb3a56b87f269648129524fb6f629418ea799889a142af516f47","url":"https://api-dashboard.search.brave.com/api-reference/web/poi_descriptions/__data.json"},{"content_hash":"sha256:dd2d3f02606cdf073906b9a6d5c5bfcce1fb568092c56fa56742b378a55657e5","url":"https://api-dashboard.search.brave.com/api-reference/web/rich_search/__data.json"},{"content_hash":"sha256:a001dfd07208f89cfcc9a34d90e4593cedc341320c669b270612086245561264","url":"https://api-dashboard.search.brave.com/api-reference/web/search/get/__data.json"},{"content_hash":"sha256:7c3c02d2a0a8cdc07d8ac787f96bcf949c684129c461f73a87374054794ab1f9","url":"https://api-dashboard.search.brave.com/api-reference/web/search/post/__data.json"}],"structured_source_hash":"sha256:3e120458b72eb3a3113d649793eccf719d67bca20a08745f6a5d92ea80159253","url":"https://api-dashboard.search.brave.com/llms.txt"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/res/v1/web/search","x-aisa-validation":"provider"}},"/apis/v1/byteplus/fetch":{"post":{"description":"Fetch a single URL and return clean, structured page content — title, body text, and publish time. `Url` is required. The response wraps `ResponseMetadata.RequestId` and a `Result` object with the parsed content. Use it to extract full page content for URLs you already have, typically pairing it with `post_byteplus_web_search` results. failed requests are not charged.\n\n\nPublished reference price: $0.0008 USD per successful request. Account-specific pricing and final settlement may differ.\n","operationId":"post_byteplus_fetch","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Fetch a page","value":{"Url":"https://example.com"}}},"schema":{"properties":{"Url":{"description":"The URL to fetch. Required.","example":"https://example.com","type":"string"}},"required":["Url"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"examples":{"success":{"summary":"Live gateway 200 response","value":{"ResponseMetadata":{"Action":"","Region":"","RequestId":"20260904155514D7EA140BFD77348BC3FC","Service":"","Version":""},"Result":{"Data":{"ContentText":"This domain is for use in documentation examples without needing permission. Avoid use in operations.\nLearn more","PublishTime":0,"StatusCode":200,"Title":"Example Domain","Url":"https://example.com"},"LogId":"20260904155514D7EA140BFD77348BC3FC"}}}},"schema":{"properties":{"ResponseMetadata":{"description":"Upstream request metadata.","properties":{"Action":{"type":"string"},"Region":{"type":"string"},"RequestId":{"description":"Unique identifier for this request.","type":"string"},"Service":{"type":"string"},"Version":{"type":"string"}},"type":"object"},"Result":{"description":"Fetch result payload.","properties":{"Data":{"description":"Structured page content.","properties":{"ContentText":{"description":"Clean body text extracted from the page.","type":"string"},"PublishTime":{"description":"Detected publish time as Unix seconds (0 if unknown).","type":"integer"},"StatusCode":{"description":"HTTP status code of the fetched page.","type":"integer"},"Title":{"description":"Page title.","type":"string"},"Url":{"description":"The fetched URL.","type":"string"}},"type":"object"},"LogId":{"description":"Upstream log id (equals ResponseMetadata.RequestId).","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Fetch completed successfully. `Result` holds the structured page content."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"BytePlus Fetch","tags":["byteplus"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"byteplus-search","x-aisa-category":"search","x-aisa-docs-url":"https://aisa.one/docs/api-reference/search/post_byteplus-fetch","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0008,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-provider":"byteplus-search","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"byteplus-search","x-aisa-response-source":{"content_hash":"sha256:4d783e21f4c2d1591554a3d5171cf636931a0b646dc725ccf0e62c6bc8c0d104","kind":"upstream_success_contract","source":{"content_hash":"sha256:8c1e87b57aedc3a44c19c4502f743843c6dbb02a9c62f4fd814a617e8ade0ed0","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:6abd39280a9f351ec4d7d7cf8edb2124fe283a6922d839e72bf7ab3b4c0f9cd7","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/byteplus-search.json"}},"x-aisa-revision":{"customer_pricing_ref":"4928e9c54c0e","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c0d2608b0fad"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_byteplus_fetch","path":"/apis/v1/byteplus/fetch"},"x-aisa-source":{"content_hash":"sha256:8c1e87b57aedc3a44c19c4502f743843c6dbb02a9c62f4fd814a617e8ade0ed0","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:6abd39280a9f351ec4d7d7cf8edb2124fe283a6922d839e72bf7ab3b4c0f9cd7","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/byteplus-search.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/search_api/fetch","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/byteplus/fetch \\\n --header 'Authorization: Bearer
required field
UTF-8 encoding
The maximum number of keywords you can specify: 1000;
The maximum number of characters in a single keyword: 250;
The keywords will be converted to lowercase format;keyword and keywords fields in DataForSEO APIs in this Help Center article","items":{"type":"string"},"type":"array"},"language_code":{"description":"language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:en","type":"string"},"language_name":{"description":"full name of the language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages with their language_name by making a separate request to thehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:English","type":"string"},"location_code":{"description":"unique location identifier
required field if you don't specify location_name
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:2840","type":"integer"},"location_name":{"description":"full name of the location
required field if you don't specify location_code
Note: it is required to specify either location_name or location_code
you can receive the list of available locations with their location_name by making a separate request to thehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
example:United Kingdom","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"AI Keyword Data Keyword Search Volume","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-ai-keyword-data-keywords-search-volume-live","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.011,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:4d55e9f4704e36adf1a91a915c4e00959378f8de4086637d1fd0255fd6712cbe","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"8e606c70f96c"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_keyword_volume_live","path":"/apis/v1/dataforseo/ai_optimization/ai_keyword_data/keywords_search_volume/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/ai_keyword_data/keywords_search_volume/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/ai_keyword_data/keywords_search_volume/live \\\n --header 'Authorization: Bearer
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response
Note #2: not supported in reasoning models","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value for reasoning models (e.g., reasoning is true in the Models endpoint): 1024;
minimum value for non-reasoning models: 16;
maximum value: 4096;
default value: 2048
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gpt-4.1 is specified, the gpt-4.1-2025-04-14 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 2
default value: 0.94
Note: not supported in reasoning models","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: 0.92top_p cannot be used together with temperature in the same request","type":["number","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search
optional field
when enabled, the AI model can access and cite current web information;
default value: false;
Note: refer to the Models endpoint for a list of models that support web_search;","type":["boolean","null"]},"web_search_city":{"description":"city name of the location
optional field
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model will search the web from the country you specify;
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live ChatGPT LLM Responses","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-chat-gpt-llm-responses-live","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0695,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:89ead7b7869e24eabb9b7639419562e1b74457ddcf1bb712e107e7ffc0ce7e3a","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"9f8036ce16a5"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_chat_gpt_llm_responses_live","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_responses/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/live \\\n --header 'Authorization: Bearer
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskGetResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get LLM Responses Chat GPT Results by id","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/get_dataforseo-ai-optimization-chat-gpt-llm-responses-task-get-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:dc1ac35a71c097fc334b6b43bbb9646f699f5b826f85e818e6d7c2f29a19643f","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"7f404c4c2676"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_dataforseo_ai_chat_gpt_llm_responses_fetch","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_get/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_responses/task_get/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_get/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response
Note #2: not supported in reasoning models","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value for reasoning models (e.g., reasoning is true in the Models endpoint): 1024;
minimum value for non-reasoning models: 16;
maximum value: 4096;
default value: 2048","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gpt-4.1 is specified, the gpt-4.1-2025-04-14 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
defines the AI's role, tone, or specific behavior;
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data array of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 2
default value: 0.94
Note: not supported in reasoning models","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: 0.92top_p cannot be used together with temperature in the same request","type":["number","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search
optional field
when enabled, the AI model can access and cite current web information;
default value: false;
Note: refer to the Models endpoint for a list of models that support web_search;","type":["boolean","null"]},"web_search_city":{"description":"city name of the location
optional field
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model will search the web from the country you specify;
Note: not supported in o3-mini, o1-pro, o1 models","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Setting ‘LLM Responses ChatGPT’ Tasks","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-chat-gpt-llm-responses-task-post","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:a735df5ab2558146ae9a1ebb554a03c2483c06069d2c9e11f25ce48fbc2775e1","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"840bb1f542cb"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_chat_gpt_llm_responses_submit","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_responses/task_post","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post \\\n --header 'Authorization: Bearer
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live ChatGPT LLM Scraper","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-chat-gpt-llm-scraper-live-advanced","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.004,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:2b0b8257a44af5aa1c066f599bc8d033127f483ca9f7caf36f3ccd51dbd9e153","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"46b919a36735"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_chat_gpt_llm_scraper_live","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced \\\n --header 'Authorization: Bearer
optional field
to enable this parameter, force_web_search must also be enabled;
when enabled, the endpoint will return HTML data from the expanded citation bar;
default value: false","type":["boolean","null"]},"force_web_search":{"description":"force AI agent to use web search
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/locations
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperLiveHtmlResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live ChatGPT LLM Scraper API HTML","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-chat-gpt-llm-scraper-live-html","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:83d0520756c39618680f1d3ba5e607219c8c4ec164798643f6c3019b13541494","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"1b922c9f14cd"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_chat_gpt_llm_scraper_live_html","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_scraper/live/html","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html \\\n --header 'Authorization: Bearer
a universally unique identifier (UUID)
unique task identifier in our system
you will be able to use it within 30 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get ChatGPT LLM Scraper Advanced Results by id","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/get_dataforseo-ai-optimization-chat-gpt-llm-scraper-task-get-advanced-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:49c81f611c3638bdbc20c7996a9688057254d6d4b6e2cb048258360abd0759ff","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2c5b9d413445"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_dataforseo_ai_chat_gpt_llm_scraper_fetch","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskGetHtmlResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get Ai Optimization Chat Gpt Llm Scraper Html Results by id","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_a2f83f","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:4a8a995059482a21f9ae035f1315b7c79ed69ba5724316ad32c004d7559d1e9c","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e35c4dcdefbe"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_a2f83f","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/html/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
optional field
to enable this parameter, force_web_search must also be enabled;
when enabled, the HTML endpoint will return data from the expanded citation bar;
default value: false","type":["boolean","null"]},"force_web_search":{"description":"force AI agent to use web search
optional field
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languagesn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:2840","type":"integer"},"location_name":{"description":"full name of search engine location
required field if you don't specify location_code
if you use this field, you don't need to specify location_code
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
example:United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the function you used for setting a task
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationChatGptLlmScraperTaskPostResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Setting Ai Optimization Chat Gpt Llm Scraper Tasks","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_410e81","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:bae829548ddf8321e7c39faef665dc9d3902b318f95ad266296644325e6a8def","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"611f42828a45"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_410e81","path":"/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_post"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/chat_gpt/llm_scraper/task_post","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_post \\\n --header 'Authorization: Bearer
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1;
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1025","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if claude-opus-4-0 is specified, the claude-opus-4-20250514 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behaviour
optional field
defines the AI's role, tone, or specific behavior;
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 1
default value: 0.7temperature cannot be used together with top_p in the same request","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: nulltop_p cannot be used together with temperature in the same request","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1025
Note #2: if set to true, force_web_search must be set to false
Note #3: if set to true, the temperature and top_p cannot be used","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]},"web_search_city":{"description":"city name of the location used for searching the web
optional field
","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location used for searching the web
optional field
possible values: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Claude LLM Responses","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-claude-llm-responses-live","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0567,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:b5254940463338c8415de81355b2516c6f906f0f56ac996e5f76a45a1a9410d6","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"eaeb4bc3f852"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_claude_llm_responses_live","path":"/apis/v1/dataforseo/ai_optimization/claude/llm_responses/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/claude/llm_responses/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/claude/llm_responses/live \\\n --header 'Authorization: Bearer
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskGetResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get LLM Responses Claude Results by id","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/get_dataforseo-ai-optimization-claude-llm-responses-task-get-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:3bcd7888feeb9d42b4c38ff878b0ea9734848d4c9e4ec84390930970c3ff8e48","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6428e8d54f33"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_dataforseo_ai_claude_llm_responses_fetch","path":"/apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_get/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/claude/llm_responses/task_get/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_get/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
optional field
to enable this parameter, web_search must also be enabled;
when enabled, the AI model is forced to access and cite current web information;
default value: false;
Note: even if the parameter is set to true, there is no guarantee web sources will be cited in the response","type":["boolean","null"]},"max_output_tokens":{"description":"maximum number of tokens in the AI response
optional field
minimum value: 1;
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1025","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if claude-opus-4-0 is specified, the claude-opus-4-20250514 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
defines the AI's role, tone, or specific behavior;
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse;
lower values make output more focused;
minimum value: 0
maximum value: 1
default value: 0.7temperature cannot be used together with top_p in the same request","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection;
minimum value: 0
maximum value: 1
default value: nulltop_p cannot be used together with temperature in the same request","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1025
Note #2: if set to true, force_web_search must be set to false
Note #3: if set to true, the temperature and top_p cannot be used","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]},"web_search_city":{"description":"city name of the location used for searching the web
optional field
","type":["string","null"]},"web_search_country_iso_code":{"description":"ISO country code of the location used for searching the web
optional field
possible values: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Setting LLM Responses Claude Tasks","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-claude-llm-responses-task-post","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:9a07d5909cd530229b58b2f1b5ea1d9438e0d4a859f86c3419eb2576535037ef","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6862d360a0ea"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_claude_llm_responses_submit","path":"/apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_post"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/claude/llm_responses/task_post","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_post \\\n --header 'Authorization: Bearer
optional field
minimum value: 1
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1024","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gemini-1.5-pro is specified, the gemini-1.5-pro-002 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models","type":"string"},"system_message":{"description":"instructions for the AI behavior
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse
lower values make output more focused
minimum value: 0
maximum value: 2
default value: 1.3","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection
minimum value: 0
maximum value: 1
default value: 0.9","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1024
Note #2: for Gemini Pro models, the use_reasoning will automatically be set to true","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Gemini LLM Responses","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-gemini-llm-responses-live","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0707,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:964cf3ad422bdcf5be2d3fdfad9b137502bc2686c54498296d032afd45382fe1","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"8cde44df7c64"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_gemini_llm_responses_live","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_responses/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_responses/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_responses/live \\\n --header 'Authorization: Bearer
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskGetResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get LLM Responses Gemini Results by id","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/get_dataforseo-ai-optimization-gemini-llm-responses-task-get-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:bc302aef42d851cf8688ed643d35be771e9bffe08efb018d4dea75eccb363388","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"4b4ea183901e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_dataforseo_ai_gemini_llm_responses_fetch","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_get/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_responses/task_get/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_get/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
optional field
minimum value: 1;
maximum value: 4096;
default value: 2048;
Note: if web_search is set to true or the reasoning model is specified in the request, the output token count may exceed the specified max_output_tokens limit
Note #2: if use_reasoning is set to true, the minimum value for max_output_tokens is 1024","type":["integer","null"]},"message_chain":{"description":"conversation history\noptional field\narray of message objects representing previous conversation turns;\neach object must contain:\nrole string with either user or ai role;\nmessage string with message content (max 500 characters);\nyou can specify maximum of 10 message objects in the array;\nNote: for Perplexity models, messages must strictly alternate between user and AI roles (user → ai);\nexample:\n\"message_chain\": [{\"role\":\"user\",\"message\":\"Hello, what’s up?\"},{\"role\":\"ai\",\"message\":\"Hello! I’m doing well, thank you. How can I assist you today?\"}]","items":{"oneOf":[{"properties":{"message":{"description":"message text","type":["string","null"]},"role":{"description":"role of the user from whom the message originates","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]},"model_name":{"description":"name of the AI model
required fieldmodel_nameconsists of the actual model name and version name;
if the basic model name is specified, its latest version will be set by default;
for example, if gemini-1.5-pro is specified, the gemini-1.5-pro-002 will be set as model_name automatically;
you can receive the list of available LLM models by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special character in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special character in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
defines the AI's role, tone, or specific behavior
you can specify up to 500 characters in the system_message field","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"temperature":{"description":"randomness of the AI response
optional field
higher values make output more diverse
lower values make output more focused
minimum value: 0
maximum value: 2
default value: 1.3","type":["number","null"]},"top_p":{"description":"diversity of the AI response
optional field
controls diversity of the response by limiting token selection
minimum value: 0
maximum value: 1
default value: 0.9","type":["number","null"]},"use_reasoning":{"description":"enable reasoning for the AI model
optional field
when enabled, the model will perform reasoning before generating a response
refer to the Models endpoint for a list of models that support reasoning
default value: false
Note: if set to true, the minimum value for max_output_tokens is 1024
Note #2: for Gemini Pro models, the use_reasoning will automatically be set to true","type":["boolean","null"]},"user_prompt":{"description":"prompt for the AI model
required field
the question or task you want to send to the AI model;
you can specify up to 500 characters in the user_prompt field","type":"string"},"web_search":{"description":"enable web search for current information
optional field
when enabled, the AI model can access and cite current web information;
Note: refer to the Models endpoint for a list of models that support web_search;
default value: false;
The cost of the parameter can be calculated on the Pricing page","type":["boolean","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Setting ‘LLM Responses Gemini’ Tasks","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-gemini-llm-responses-task-post","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:31af08cb9f0d53307a21cdcb66363be24cc133955f83ed7e571f60349afb4fc5","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"cbd60a8b80e4"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_gemini_llm_responses_submit","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_post"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_responses/task_post","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_post \\\n --header 'Authorization: Bearer
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example: enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example: English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:2840","type":"integer"},"location_coordinate":{"description":"location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveAdvancedResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Gemini LLM Scraper Advanced","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-gemini-llm-scraper-live-advanced","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:4aee9ab06312536b6766a2a28be0b17df929c570973c5b52f080c28d9e96e2d1","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e1aac135d605"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_gemini_llm_scraper_live","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_scraper/live/advanced","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced \\\n --header 'Authorization: Bearer
optional field
when enabled, the endpoint will return HTML data from the expanded citation bar;
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name
if you use this field, you don't need to specify language_name
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:enn","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code
if you use this field, you don't need to specify language_code
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:2840","type":"integer"},"location_coordinate":{"description":"location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:United States","type":"string"},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperLiveHtmlResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Gemini LLM Scraper HTML","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-gemini-llm-scraper-live-html","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:ceb1da4e5ad9db93271425798d676f2050a9dab2e8a963d1d96a8a343c3c8f8d","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"ff8d8f0a964e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_gemini_llm_scraper_live_html","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/html"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_scraper/live/html","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/html \\\n --header 'Authorization: Bearer
a universally unique identifier (UUID)
unique task identifier in our system
you will be able to use it within 30 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetAdvancedResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get Gemini LLM Scraper Advanced","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/get_dataforseo-ai-optimization-gemini-llm-scraper-task-get-advanced-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:efcf00ff422ac7ffd8ade5ba6c7a59fda941641bdf506659033cb2b6234cf0af","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"380402679bcd"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_dataforseo_ai_gemini_llm_scraper_fetch","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/advanced/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_scraper/task_get/advanced/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/advanced/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time","example":"00000000-0000-0000-0000-000000000000","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskGetHtmlResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Get Gemini LLM Scraper HTML","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/get_dataforseo-ai-optimization-gemini-llm-scraper-task-get-html-id","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"explicit_zero","customer_pricing":"fixed_success","default_request_estimate_usd":0,"estimate_source":"customer_pricing_fixed","evidence_source":"request_snapshot"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:44571a996534c296adb43f0acdcdc4f90bd4510260b43362fd706730f3356ba3","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"997eb61c224f","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"014ab171a152"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"get_dataforseo_ai_gemini_llm_scraper_fetch_html","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/html/{id}"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_scraper/task_get/html/{id}","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/html/00000000-0000-0000-0000-000000000000 \\\n --header 'Authorization: Bearer
optional field
when enabled, the HTML endpoint will return data from the expanded citation bar;
default value: false","type":["boolean","null"]},"keyword":{"description":"keyword
required field
you can specify up to 2000 characters in the keyword field
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for your keyword, please specify it as “%25”;
if you need to use the “+” character for your keyword, please specify it as “%2B”keyword and keywords fields in DataForSEO APIs in this Help Center article","type":"string"},"language_code":{"description":"search engine language code
required field if you don't specify language_name;
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:en","type":"string"},"language_name":{"description":"full name of search engine language
required field if you don't specify language_code;
if you use this field, you don't need to specify language_code;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
example:English","type":"string"},"location_code":{"description":"search engine location code
required field if you don't specify location_name or location_coordinate
if you use this field, you don't need to specify location_name or location_coordinate
you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:2840","type":"integer"},"location_coordinate":{"description":"location_name or location_codelocation_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" format53.476225,-2.243572,200
required field if you don't specify location_code or location_coordinate
if you use this field, you don't need to specify location_code or location_coordinate
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
example:United States","type":"string"},"pingback_url":{"description":"notification URL of a completed task
optional field
when a task is completed we will notify you by GET request sent to the URL you have specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Note: special characters in pingback_url will be urlencoded;
i.a., the # character will be encoded into %23
required field if you specify postback_url
corresponds to the function you used for setting a task
possible values:advanced, html","type":"string"},"postback_url":{"description":"URL for sending task results
optional field
once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified
you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request.
example:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Note: special characters in postback_url will be urlencoded;
i.a., the # character will be encoded into %23
optional field
can take the following values:
1 – normal execution priority (set by default)
2 – high execution priorityYou will be additionally charged for the tasks with high execution priority.
The cost can be calculated on the Pricing page.","type":["integer","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationGeminiLlmScraperTaskPostResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Setting Gemini LLM Scraper","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/post_dataforseo-ai-optimization-gemini-llm-scraper-task-post","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.701,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:4e3dc7e3cf01f9eef4cc01887af18aa60fa3d728b788954a55728d6a401ceee6","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"d1b4220f0f0b"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_dataforseo_ai_gemini_llm_scraper_submit","path":"/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_post"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/gemini/llm_scraper/task_post","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_post \\\n --header 'Authorization: Bearer
optional field
minimal value 2025-08-01
date format \"yyyy-mm-dd\"","type":["string","null"]},"date_to":{"description":"end date of the time range
optional field
Note value specified in date_from cannot exceed the value in date_to
date format \"yyyy-mm-dd\"","type":["string","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsHistoricalLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Historical","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_e9ddb6","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:8c75027b7777f150971705018f60c50e48171e054c66aeecf14c246b940d25d0","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"103334b0d11e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_e9ddb6","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/historical/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/historical/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/historical/live \\\n --header 'Authorization: Bearer
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domainsearch_results_domain
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"the maximum number of returned objects
optional field100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000, use the search_after_token if you would like to offset more results","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"targets":{"items":{"oneOf":[{"properties":{"key":{"description":"key for grouping the results\nrequired field\ngroups results for comparison and serves as a label for the group;\nyou can specify up to 250 characters in the key field","type":["string","null"]},"target":{"items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsMultiTargetMetricsLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Multi Target Metrics","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_5d5a92","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:cbcd2a9d50505bb9b7b4546db8f39c7b2cf8ccd8f9ffbe175a53ee937f8126e1","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c5266bcffb43"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_5d5a92","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/multi_target_metrics/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live \\\n --header 'Authorization: Bearer
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"the maximum number of returned objects
optional field100
maximum value: 1000","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000, use the search_after_token if you would like to offset more results","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"search_after_token":{"description":"token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 1000 results in a single request;
by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;
Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsSearchMentionsLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Search Mentions","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_50bbc1","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:4dbdc8e2e7cc8803bbe65228e9f5781204e3037391995e53f9a46c8c9ff56bff","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"f806bd5c2069"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_50bbc1","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/search_mentions/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/search_mentions/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/search_mentions/live \\\n --header 'Authorization: Bearer
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domainsearch_results_domain
minimum value: 1
maximum value: 10
default value: 10","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Target Metrics","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_17238a","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:e9086e606c0970dcd0e657df90d6d4e20e0cc78eff3f3489b1daf5220760faf7","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"9097884ceb97"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_17238a","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/target_metrics/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics/live \\\n --header 'Authorization: Bearer
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTargetMetricsLiteLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Target Metrics Lite","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_a6d8ec","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:5c41e2a850ff0830a801c606ae8bba83b923d8f72b69243f15f763e22f47c449","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2db176e32fcf"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_a6d8ec","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics_lite/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/target_metrics_lite/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics_lite/live \\\n --header 'Authorization: Bearer
required field
minimal value: 2025-08-01
date format: \"yyyy-mm-dd\"","type":"string"},"date_to":{"description":"end date of the time range
required field
Note:the value specified in date_from cannot exceed the value in date_to
date format: \"yyyy-mm-dd\"","type":"string"},"group_range":{"description":"timeseries delta range
required field
possible values:day, week, month, year","type":"string"},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesDeltaLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Timeseries Delta","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_f012d1","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:34412cc94604d5de09e70a2bdd0553ed525491e0da624c21e86025918d1b954b","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"3be8abcd15a6"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_f012d1","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_delta/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/timeseries_delta/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_delta/live \\\n --header 'Authorization: Bearer
required field
minimal value: 2025-08-01
date format: \"yyyy-mm-dd\"","type":"string"},"date_to":{"description":"end date of the time range
required field
Note:the value specified in date_from cannot exceed the value in date_to
date format: \"yyyy-mm-dd\"","type":"string"},"group_range":{"description":"timeseries range
required field
possible values:day, week, month, year","type":"string"},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTimeseriesNewLostLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Timeseries New Lost","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_cec905","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:349bc1f47024c2c2a44d742b164c274cbdf4ddcaccfe653fe67b6e91bc73b205","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"b7edf34524e8"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_cec905","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_new_lost/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/timeseries_new_lost/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_new_lost/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed brand categories will be omitted from the items array
example:\"exclude_brand_categories\": [\"business\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed brand categories will be returned in the items array
example:\"include_brand_categories\": [\"business\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Brand Categories","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_340892","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:c25538df6a92e9cf3a3d376efbd8b9c58e4441a5bec576d0d10fb0a6ce54996e","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"ca1e079b9676"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_340892","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed brand categories will be omitted from the items array
example:[\"company\",\"insurance\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed brand categories will be returned in the items array
example:[\"company\",\"insurance\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandCategoriesLiteLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Brand Categories Lite","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_e666b9","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:2b7826a4f685a3fdd88b11441836d112b13dd0c02e9f28caec42737cb24bf79d","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"db364de9cfef"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_e666b9","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed brands will be omitted from the items array
example:\"exclude_brands\": [\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed brands will be returned in the items array
example:\"include_brands\": [\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Brands","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_03dcdc","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:e68730d712ac5b0e0beba468d86b71a5b24f462dccf41d08f0cacfab44fc34fb","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"bb8afc8977ff"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_03dcdc","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_brands/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed brands will be omitted from the items array
example:[\"BMW\",\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\", 1000]
optional field
if specified, only the listed brands will be returned in the items array
example:[\"BMW\",\"Audi\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: data specific to brand entities is available for chat_gpt only;
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedBrandsLiteLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Brands Lite","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_eae988","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:3e7e53f7a7047ca6c06641d1c064ea3a6daf489676d53475298f0f17d9e99867","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"bca343f75741"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_eae988","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands_lite/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_brands_lite/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands_lite/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed domains will be omitted from the items array
example:\"exclude_domains\": [\"en.wikipedia.org\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed domains will be returned in the items array
example:\"include_domains\": [\"en.wikipedia.org\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources
Note:if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Domains","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_042f7c","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:12baf50f0526afd3e9398475f1a6b7f2a79d9e80210c4e9606e45c7e9f53c6ba","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"96da05423145"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_042f7c","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_domains/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed domains will be omitted from the items array
example:[\"google.com\",\"bing.com\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed domains will be returned in the items array
example:[\"dataforseo.com\",\"seoinsider.com\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en onlyn","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources;
Note: if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
default value: google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedDomainsLiteLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Domains Lite","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_9e961b","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:8434e9594e1e50a096c247c167c1fa50c5ce64fbdc8471930bb08defbb0375b7","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"4e89ec360f46"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_9e961b","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains_lite/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_domains_lite/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains_lite/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed pages will be omitted from the items array
example:\"exclude_pages\": [\"https://example.page/\"]","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed pages will be returned in the items array
example:\"include_pages\": [\"https://example.page/\"]","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources;
Note:if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for United States only","type":["string","null"]},"offset":{"description":"offset in the results array of the returned mentions data
optional field0
example: if you specify the 10 value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;
Note: the maximum value is 1000000","type":["integer","null"]},"order_by":{"description":"results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending order
you should use a comma to set up a sorting type
example:[\"ai_search_volume,desc\"]
Note: you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules","items":{"type":"string"},"type":["array","null"]},"platform":{"description":"target platform
optional field
possible values:chat_gpt, google
Note: if the platform is not specified, the data is returned for both platforms
Note #2:chat_gpt data is available for the United States and English only","type":["string","null"]},"tag":{"description":"user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response","type":["string","null"]},"target":{"description":"array of objects containing target entities\nrequired field\nyou can specify up to 10 entities (objects) in the target field\none target entity can contain either one domain or one keyword and related parameters\nexamples:\n\ntarget array with a domain entity","items":{"oneOf":[{"discriminator":{"mapping":{"domain":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsDomainElement","keyword":"#/components/schemas/Provider0A3E90081762_AiOptimizationLLmMentionsKeywordElement"},"propertyName":"type"},"properties":{"search_filter":{"description":"target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include","type":["string","null"]},"search_scope":{"description":"target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any","items":{"type":["string","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":["array","null"]}},"type":"object"}],"type":["object","null"]},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Response0A3E90081762_AiOptimizationLlmMentionsTopMentionedPagesLiveResponseInfo"}],"type":["object","null"]}}},"description":"Successful operation"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}],"summary":"Live Ai Optimization Llm Mentions Top Mentioned Pages","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"dataforseo","x-aisa-category":"13","x-aisa-docs-url":"https://aisa.one/docs/api-reference/dataforseo/any_dataforseo_apis_v1_dataforseo_ai_optimization_7d8b87","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_usd","customer_multiplier":1,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.101,"estimate_source":"profile_seed","evidence_source":"response_body"},"x-aisa-provider":"dataforseo","x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-registry-provider":"dataforseo","x-aisa-response-source":{"content_hash":"sha256:915538925ee04aca414889adf98bfd99a03c8e667b2c06327df982a5b66402f6","kind":"upstream_success_contract","source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"}},"x-aisa-revision":{"customer_pricing_ref":"6155513a94fd","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"a795635d2742"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"any_dataforseo_apis_v1_dataforseo_ai_optimization_7d8b87","path":"/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages/live"},"x-aisa-source":{"content_hash":"sha256:4af5b8359214f2a833013bf0956702d4de186356b9ba15a9646892917d482a2c","converter":"scripts/import_dataforseo_filters.py@1","duplicate_batch_examples_removed":272,"fetched_at":"2026-10-16T11:32:33.369735+00:00","filter_json_fields_normalized":85,"kind":"provider_openapi","owner":"AIsa-team/docs","policy_revision":"sha256:718bb0ba1ba18fb3b562443eb74e96aa9057b6e584050e7817cda944fe8fea62","refresh_interval_hours":24,"refresh_policy":"automatic","review_period_days":30,"upstream_content_hash":"sha256:8539f0b2a3a415e5553c9337a97d2f74cc00e24db72cc0505ad5eab1f1e4ffff","url":"https://raw.githubusercontent.com/dataforseo/OpenApiDocumentation/master/openapi_specification.yaml"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v3/ai_optimization/llm_mentions/top_mentioned_pages/live","x-aisa-validation":"provider","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages/live \\\n --header 'Authorization: Bearer
optional field
if specified, the listed pages will be omitted from the items array
example:
`[\"https://dataforseo.com/apis/ai-optimization-api/llm-mentions-api\", \"https://dataforseo.com/apis/ai-optimization-api\"]`","items":{"type":"string"},"type":["array","null"]},"filters":{"description":"array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
optional field
if specified, only the listed pages will be returned in the items array
example:
`[\"https://dataforseo.com/apis/ai-optimization-api/llm-mentions-api\", \"https://dataforseo.com/apis/ai-optimization-api\"]`","items":{"type":"string"},"type":["array","null"]},"initial_dataset_filters":{"description":"array of filter expressions applied before aggregation
optional field
you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;
you should set a logical operator and, or between the conditions
the following operators are supported:=, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
you can use the % operator with like and not_like to match any string of zero or more characters
example:[\"ai_search_volume\",\">\",1000]
learn more about the initial dataset filters in this help center article.","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":["object","null"]},{"items":{"$ref":"#/components/schemas/Provider0A3E90081762_AisaDataforseoFilterJsonValue"},"type":"array"}],"description":"JSON representation of filter values and nested expressions. Field names, operators, condition counts and operand compatibility remain provider-validated as documented for each endpoint; this is not a complete filter-language validator."},"type":["array","null"]},"internal_list_limit":{"description":"maximum number of elements within internal arrays
optional field
you can use this field to limit the number of elements within the following arrays:sources_domain, search_results_domain, brand_entities_title, brand_entities_category
minimum value: 1
maximum value: 10
default value: 5","type":["integer","null"]},"language_code":{"description":"search language code
optional field
if you use this field, you don't need to specify language_name;
you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: en
Note: chat_gpt data is available for en only","type":["string","null"]},"language_name":{"description":"full name of search language
optional field
if you use this field, you don't need to specify language_code;
if you don't specify this field, the language_code with en value will be used by default;
you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: chat_gpt data is available for English only","type":["string","null"]},"limit":{"description":"maximum number of results in the items array
optional field
you can use this parameter to limit the number of data objects you receive in the items array
minimum value: 1
maximum value: 1000
default value: 100","type":["integer","null"]},"links_scope":{"description":"links source scope
optional field
this parameter specifies which links will be used to extract domains and aggregation data
possible values: sources, search_results
default value: sources; ;
Note: if you specify search_results, the data will be available for chat_gpt only","type":["string","null"]},"location_code":{"description":"search location code
optional field
if you use this field, you don't need to specify location_name
you can receive the list of available locations of the search engine with their location_code by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
default value: 2840
Note: chat_gpt data is available for 2840 only","type":["integer","null"]},"location_name":{"description":"full name of search location
optional field
if you use this field, you don't need to specify location_code
if you don't specify this field, the location_code with 2840 value will be used by default;
you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
Note: