> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> ## Agent Instructions (AIsa)
>
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt

# Live Ai Optimization Llm Mentions Multi Target Metrics

> DataForSEO POST /v3/ai_optimization/llm_mentions/multi_target_metrics/live

<!-- aisa-pricing:start -->
Usage-based billing; Default request estimate: $0.101 USD (not a fixed price). Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Request contract

* **Method and path:** POST /apis/v1/dataforseo/ai\_optimization/llm\_mentions/multi\_target\_metrics/live
* **Request URL template:** [https://api.aisa.one/apis/v1/dataforseo/ai\&#95;optimization/llm\&#95;mentions/multi\&#95;target\&#95;metrics/live](https://api.aisa.one/apis/v1/dataforseo/ai\&#95;optimization/llm\&#95;mentions/multi\&#95;target\&#95;metrics/live)
* **Runtime facts:** 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c

[Complete OpenAPI definition](https://aisa.one/docs/openapi/dataforseo.json)

Effective request and pricing declaration (including authentication and referenced schemas):

```json theme={null}
{
  "operationId": "any_dataforseo_apis_v1_dataforseo_ai_optimization_5d5a92",
  "method": "POST",
  "path": "/apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "type": "array",
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "targets": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "target": {
                              "type": [
                                "array",
                                "null"
                              ],
                              "items": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "search_scope": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "items": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "description": "target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any"
                                      },
                                      "search_filter": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include"
                                      }
                                    },
                                    "discriminator": {
                                      "propertyName": "type",
                                      "mapping": {
                                        "domain": "#/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsDomainElement",
                                        "keyword": "#/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsKeywordElement"
                                      }
                                    }
                                  }
                                ]
                              }
                            },
                            "key": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "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"
                            }
                          }
                        }
                      ]
                    }
                  },
                  "location_name": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "<em>full name of search location</em><br>optional field<br>if you use this field, you don't need to specify <code>location_code</code><br>if you don't specify this field, the <code>location_code</code> with <code class=\"long-string\">2840</code> value will be used by default;<br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br><strong>Note: <code>chat_gpt</code> data is available for <code class=\"long-string\">United States</code> only"
                  },
                  "location_code": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "<em>search location code</em><br>optional field<br>if you use this field, you don't need to specify <code>location_name</code><br>you can receive the list of available locations of the search engine with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br>default value: <code class=\"long-string\">2840</code><br><strong>Note: <code>chat_gpt</code> data is available for <code class=\"long-string\">2840</code> only"
                  },
                  "language_name": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "<em>full name of search language</em><br>optional field<br>if you use this field, you don't need to specify <code>language_code</code>;<br>if you don't specify this field, the <code>language_code</code> with <code class=\"long-string\">en</code> value will be used by default;<br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br><strong>Note: <code>chat_gpt</code> data is available for <code class=\"long-string\">English</code> only"
                  },
                  "language_code": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "<em>search language code</em><br>optional field<br>if you use this field, you don't need to specify <code>language_name</code>;<br>you can receive the list of available languages of the search engine with their <code>language_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br>default value: <code class=\"long-string\">en</code><br><strong>Note: <code>chat_gpt</code> data is available for <code class=\"long-string\">en</code> only"
                  },
                  "platform": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "<em>target platform</em><br>optional field<br>possible values:<br><code>chat_gpt</code>, <code>google</code><br>default value: <code class=\"long-string\">google</code><br><strong>Note:</strong> if the <code>platform</code> is not specified, the data is returned for both platforms<br><strong>Note #2:</strong><code>chat_gpt</code> data is available for the <code>United States</code> and <code>English</code> only"
                  },
                  "filters": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "description": "<em>array of results filtering parameters</em><br>optional field<br><strong>you can add several filters at once (8 filters maximum)</strong><br>you should set a logical operator <code>and</code>, <code>or</code> between the conditions<br>the following operators are supported:<br><code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>, <code>not_like</code>, <code>ilike</code>, <code>not_ilike</code>, <code>match</code>, <code>not_match</code><br>you can use the <code>%</code> operator with <code>like</code> and <code>not_like</code> to match any string of zero or more characters<br>example:<br><code>[\"ai_search_volume\",\"&gt;\",1000]</code><p>The full list of possible filters is available <a href=\"/v3/ai_optimization/llm_mentions/filters/\" rel=\"noopener noreferrer\" target=\"_blank\">here.</a>"
                  },
                  "initial_dataset_filters": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "description": "<em>array of filter expressions applied before aggregation</em><br>optional field<br>you can use this array to filter expressions applied to the raw mentions database before aggregation to limit the rows contributing to the result;<p><strong>you can add several filters at once (8 filters maximum)</strong><br>you should set a logical operator <code>and</code>, <code>or</code> between the conditions<br>the following operators are supported:<br><code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>, <code>not_like</code>, <code>ilike</code>, <code>not_ilike</code>, <code>match</code>, <code>not_match</code><br>you can use the <code>%</code> operator with <code>like</code> and <code>not_like</code> to match any string of zero or more characters<br>example:<br><code>[\"ai_search_volume\",\"&gt;\",1000]</code><p>the full list of possible filters is available <a href=\"/v3/ai_optimization/llm_mentions/filters\" rel=\"noopener noreferrer\" target=\"_blank\">here.</a><br>learn more about the initial dataset filters in <a href=\"https://dataforseo.com/help-center/what-are-the-initial-dataset-filters-and-how-do-they-work\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article.</a>"
                  },
                  "order_by": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "string"
                    },
                    "description": "<em>results sorting rules</em><br>optional field<br>you can use the same values as in the <code>filters</code> array to sort the results<br>possible sorting types:<br><code>asc</code> - results will be sorted in the ascending order<br><code>desc</code> - results will be sorted in the descending order<br>you should use a comma to set up a sorting type<br>example:<br><code>[\"ai_search_volume,desc\"]</code><br><strong>Note:</strong> you can set no more than three sorting rules in a single request<br>you should use a comma to separate several sorting rules"
                  },
                  "limit": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "<em>the maximum number of returned objects</em><br>optional field<p>default value: <code>100</code><br>maximum value: <code>1000</code>"
                  },
                  "offset": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "<em>offset in the results array of the returned mentions data</em><br>optional field<p>default value: <code>0</code><br>example: if you specify the <code>10</code> value, the first ten mentions objects in the results array will be omitted and the data will be provided for the successive objects;<br><strong>Note:</strong> the maximum value is <code>1000000</code>, use the <code>search_after_token</code> if you would like to offset more results"
                  },
                  "internal_list_limit": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "<em>maximum number of elements within internal arrays</em><br>optional field<br>you can use this field to limit the number of elements within the following arrays:<br><code>sources_domain</code><br><code>search_results_domain</code><br>minimum value: <code>1</code><br>maximum value: <code>10</code><br>default value: <code>5</code>"
                  },
                  "tag": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response"
                  }
                },
                "example": [
                  {
                    "language_code": "en",
                    "location_code": 2840,
                    "platform": "google",
                    "targets": [
                      {
                        "key": "chat_gpt",
                        "target": [
                          {
                            "keyword": "chat gpt"
                          }
                        ]
                      },
                      {
                        "key": "claude",
                        "target": [
                          {
                            "keyword": "claude"
                          }
                        ]
                      },
                      {
                        "key": "gemini",
                        "target": [
                          {
                            "keyword": "gemini"
                          }
                        ]
                      },
                      {
                        "key": "perplexity",
                        "target": [
                          {
                            "keyword": "perplexity",
                            "search_filter": "include"
                          }
                        ]
                      }
                    ],
                    "initial_dataset_filters": [
                      [
                        "ai_search_volume",
                        ">",
                        10
                      ]
                    ],
                    "internal_list_limit": 5
                  }
                ]
              }
            ]
          },
          "example": [
            {
              "language_code": "en",
              "location_code": 2840,
              "platform": "google",
              "targets": [
                {
                  "key": "chat_gpt",
                  "target": [
                    {
                      "keyword": "chat gpt"
                    }
                  ]
                },
                {
                  "key": "claude",
                  "target": [
                    {
                      "keyword": "claude"
                    }
                  ]
                },
                {
                  "key": "gemini",
                  "target": [
                    {
                      "keyword": "gemini"
                    }
                  ]
                },
                {
                  "key": "perplexity",
                  "target": [
                    {
                      "keyword": "perplexity",
                      "search_filter": "include"
                    }
                  ]
                }
              ],
              "initial_dataset_filters": [
                [
                  "ai_search_volume",
                  ">",
                  10
                ]
              ],
              "internal_list_limit": 5
            }
          ]
        }
      }
    }
  },
  "x-aisa-pricing": {
    "cost_contract": "response_usd",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.101,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body"
  },
  "components": {
    "schemas": {
      "Provider463397119C53_AiOptimizationLLmMentionsDomainElement": {
        "allOf": [
          {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Provider463397119C53_BaseAiOptimizationLLmMentionsTargetElement"
              }
            ]
          },
          {
            "type": "object",
            "properties": {
              "domain": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "target domain\nrequired field if you don’t specify keyword\na domain should be specified without https:// and www."
              },
              "include_subdomains": {
                "type": [
                  "boolean",
                  "null"
                ],
                "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"
              }
            }
          }
        ]
      },
      "Provider463397119C53_BaseAiOptimizationLLmMentionsTargetElement": {
        "type": "object",
        "properties": {
          "search_scope": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "target domain search scope\noptional field\npossible values:\nany, sources, search_results\ndefault value: any"
          },
          "search_filter": {
            "type": [
              "string",
              "null"
            ],
            "description": "target domain search filter\noptional field\npossible values:\ninclude, exclude\ndefault value: include"
          }
        },
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "domain": "#/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsDomainElement",
            "keyword": "#/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsKeywordElement"
          }
        }
      },
      "Provider463397119C53_AiOptimizationLLmMentionsKeywordElement": {
        "allOf": [
          {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Provider463397119C53_BaseAiOptimizationLLmMentionsTargetElement"
              }
            ]
          },
          {
            "type": "object",
            "properties": {
              "keyword": {
                "type": [
                  "string",
                  "null"
                ],
                "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"
              },
              "match_type": {
                "type": [
                  "string",
                  "null"
                ],
                "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"
              }
            }
          }
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```

## Cost and request rules

Usage-based billing; Default request estimate: \$0.101 USD (not a fixed price). Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

* **Default request reference estimate (USD):** 0.101
* **Cost contract:** response\_usd
* **Published reference multiplier:** 1.0
* **Settlement evidence source:** response\_body


## OpenAPI

````yaml openapi/dataforseo.json POST /apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live
openapi: 3.1.0
info:
  description: ''
  title: DataForSEO
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - >-
      /apis/v1/dataforseo/ai_optimization/ai_keyword_data/keywords_search_volume/live
    - >-
      /apis/v1/dataforseo/ai_optimization/ai_keyword_data/locations_and_languages
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/live
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/models
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_get/{id}
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/tasks_ready
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html
    - >-
      /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}
    - >-
      /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id}
    - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_post
    - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/live
    - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/models
    - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_get/{id}
    - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_post
    - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/tasks_ready
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/live
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/models
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_get/{id}
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_post
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/tasks_ready
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/languages
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/html
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/locations
    - >-
      /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/advanced/{id}
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/html/{id}
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_post
    - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/tasks_ready
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/available_filters
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/historical/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/locations_and_languages
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/search/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/search_mentions/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics_lite/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_delta/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_new_lost/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_domains/live
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories/live
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands/live
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands_lite/live
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains/live
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains_lite/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages/live
    - >-
      /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages_lite/live
    - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_pages/live
    - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/live
    - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/models
    - /apis/v1/dataforseo/app_data/apple/app_info/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/apple/app_info/task_post
    - /apis/v1/dataforseo/app_data/apple/app_list/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/apple/app_list/task_post
    - /apis/v1/dataforseo/app_data/apple/app_listings/categories
    - /apis/v1/dataforseo/app_data/apple/app_listings/search/live
    - /apis/v1/dataforseo/app_data/apple/app_reviews/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/apple/app_reviews/task_post
    - /apis/v1/dataforseo/app_data/apple/app_searches/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/apple/app_searches/task_post
    - /apis/v1/dataforseo/app_data/apple/categories
    - /apis/v1/dataforseo/app_data/apple/languages
    - /apis/v1/dataforseo/app_data/apple/locations
    - /apis/v1/dataforseo/app_data/google/app_info/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/google/app_info/task_get/html/{id}
    - /apis/v1/dataforseo/app_data/google/app_info/task_post
    - /apis/v1/dataforseo/app_data/google/app_list/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/google/app_list/task_get/html/{id}
    - /apis/v1/dataforseo/app_data/google/app_list/task_post
    - /apis/v1/dataforseo/app_data/google/app_listings/categories
    - /apis/v1/dataforseo/app_data/google/app_listings/search/live
    - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/html/{id}
    - /apis/v1/dataforseo/app_data/google/app_reviews/task_post
    - /apis/v1/dataforseo/app_data/google/app_searches/task_get/advanced/{id}
    - /apis/v1/dataforseo/app_data/google/app_searches/task_get/html/{id}
    - /apis/v1/dataforseo/app_data/google/app_searches/task_post
    - /apis/v1/dataforseo/app_data/google/categories
    - /apis/v1/dataforseo/app_data/google/languages
    - /apis/v1/dataforseo/app_data/google/locations
    - /apis/v1/dataforseo/backlinks/anchors/live
    - /apis/v1/dataforseo/backlinks/backlinks/live
    - /apis/v1/dataforseo/backlinks/bulk_backlinks/live
    - /apis/v1/dataforseo/backlinks/bulk_new_lost_backlinks/live
    - /apis/v1/dataforseo/backlinks/bulk_new_lost_referring_domains/live
    - /apis/v1/dataforseo/backlinks/bulk_pages_summary/live
    - /apis/v1/dataforseo/backlinks/bulk_ranks/live
    - /apis/v1/dataforseo/backlinks/bulk_referring_domains/live
    - /apis/v1/dataforseo/backlinks/bulk_spam_score/live
    - /apis/v1/dataforseo/backlinks/competitors/live
    - /apis/v1/dataforseo/backlinks/domain_intersection/live
    - /apis/v1/dataforseo/backlinks/domain_pages/live
    - /apis/v1/dataforseo/backlinks/domain_pages_summary/live
    - /apis/v1/dataforseo/backlinks/history/live
    - /apis/v1/dataforseo/backlinks/index
    - /apis/v1/dataforseo/backlinks/page_intersection/live
    - /apis/v1/dataforseo/backlinks/referring_domains/live
    - /apis/v1/dataforseo/backlinks/referring_networks/live
    - /apis/v1/dataforseo/backlinks/summary/live
    - /apis/v1/dataforseo/backlinks/timeseries_new_lost_summary/live
    - /apis/v1/dataforseo/backlinks/timeseries_summary/live
    - /apis/v1/dataforseo/business_data/business_listings/search/live
    - /apis/v1/dataforseo/business_data/google/extended_reviews/task_get/{id}
    - /apis/v1/dataforseo/business_data/google/extended_reviews/task_post
    - /apis/v1/dataforseo/business_data/google/extended_reviews/tasks_ready
    - /apis/v1/dataforseo/business_data/google/hotel_info/live/advanced
    - /apis/v1/dataforseo/business_data/google/hotel_info/live/html
    - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}
    - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/html/{id}
    - /apis/v1/dataforseo/business_data/google/hotel_info/task_post
    - /apis/v1/dataforseo/business_data/google/hotel_info/tasks_ready
    - /apis/v1/dataforseo/business_data/google/hotel_searches/live
    - /apis/v1/dataforseo/business_data/google/hotel_searches/task_get/{id}
    - /apis/v1/dataforseo/business_data/google/hotel_searches/task_post
    - /apis/v1/dataforseo/business_data/google/hotel_searches/tasks_ready
    - /apis/v1/dataforseo/business_data/google/my_business_info/live
    - /apis/v1/dataforseo/business_data/google/my_business_info/task_get/{id}
    - /apis/v1/dataforseo/business_data/google/my_business_info/task_post
    - /apis/v1/dataforseo/business_data/google/my_business_info/tasks_ready
    - /apis/v1/dataforseo/business_data/google/my_business_updates/task_get/{id}
    - /apis/v1/dataforseo/business_data/google/my_business_updates/task_post
    - /apis/v1/dataforseo/business_data/google/my_business_updates/tasks_ready
    - /apis/v1/dataforseo/business_data/google/questions_and_answers/live
    - >-
      /apis/v1/dataforseo/business_data/google/questions_and_answers/task_get/{id}
    - /apis/v1/dataforseo/business_data/google/questions_and_answers/task_post
    - /apis/v1/dataforseo/business_data/google/questions_and_answers/tasks_ready
    - /apis/v1/dataforseo/business_data/google/reviews/task_get/{id}
    - /apis/v1/dataforseo/business_data/google/reviews/task_post
    - /apis/v1/dataforseo/business_data/google/reviews/tasks_ready
    - /apis/v1/dataforseo/business_data/social_media/pinterest/live
    - /apis/v1/dataforseo/business_data/social_media/reddit/live
    - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_get/{id}
    - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post
    - /apis/v1/dataforseo/business_data/tripadvisor/reviews/tasks_ready
    - /apis/v1/dataforseo/business_data/tripadvisor/search/task_get/{id}
    - /apis/v1/dataforseo/business_data/tripadvisor/search/task_post
    - /apis/v1/dataforseo/business_data/tripadvisor/search/tasks_ready
    - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_get/{id}
    - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_post
    - /apis/v1/dataforseo/business_data/trustpilot/reviews/tasks_ready
    - /apis/v1/dataforseo/business_data/trustpilot/search/task_get/{id}
    - /apis/v1/dataforseo/business_data/trustpilot/search/task_post
    - /apis/v1/dataforseo/business_data/trustpilot/search/tasks_ready
    - /apis/v1/dataforseo/content_analysis/available_filters
    - /apis/v1/dataforseo/content_analysis/categories
    - /apis/v1/dataforseo/content_analysis/category_trends/live
    - /apis/v1/dataforseo/content_analysis/languages
    - /apis/v1/dataforseo/content_analysis/locations
    - /apis/v1/dataforseo/content_analysis/phrase_trends/live
    - /apis/v1/dataforseo/content_analysis/rating_distribution/live
    - /apis/v1/dataforseo/content_analysis/search/live
    - /apis/v1/dataforseo/content_analysis/sentiment_analysis/live
    - /apis/v1/dataforseo/content_analysis/summary/live
    - /apis/v1/dataforseo/dataforseo_labs/amazon/bulk_search_volume/live
    - /apis/v1/dataforseo/dataforseo_labs/amazon/product_competitors/live
    - >-
      /apis/v1/dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live
    - /apis/v1/dataforseo/dataforseo_labs/amazon/product_rank_overview/live
    - /apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live
    - /apis/v1/dataforseo/dataforseo_labs/amazon/related_keywords/live
    - /apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/live
    - /apis/v1/dataforseo/dataforseo_labs/apple/app_intersection/live
    - /apis/v1/dataforseo/dataforseo_labs/apple/bulk_app_metrics/live
    - /apis/v1/dataforseo/dataforseo_labs/apple/keywords_for_app/live
    - /apis/v1/dataforseo/dataforseo_labs/available_filters
    - /apis/v1/dataforseo/dataforseo_labs/google/app_competitors/live
    - /apis/v1/dataforseo/dataforseo_labs/google/app_intersection/live
    - /apis/v1/dataforseo/dataforseo_labs/google/available_history
    - /apis/v1/dataforseo/dataforseo_labs/google/bulk_app_metrics/live
    - /apis/v1/dataforseo/dataforseo_labs/google/bulk_keyword_difficulty/live
    - /apis/v1/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live
    - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_domain/live
    - >-
      /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/languages
    - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/live
    - /apis/v1/dataforseo/dataforseo_labs/google/competitors_domain/live
    - /apis/v1/dataforseo/dataforseo_labs/google/domain_intersection/live
    - >-
      /apis/v1/dataforseo/dataforseo_labs/google/domain_metrics_by_categories/live
    - /apis/v1/dataforseo/dataforseo_labs/google/domain_rank_overview/live
    - >-
      /apis/v1/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live
    - /apis/v1/dataforseo/dataforseo_labs/google/historical_keyword_data/live
    - /apis/v1/dataforseo/dataforseo_labs/google/historical_rank_overview/live
    - /apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live
    - /apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live
    - /apis/v1/dataforseo/dataforseo_labs/google/keyword_ideas/live
    - /apis/v1/dataforseo/dataforseo_labs/google/keyword_overview/live
    - /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live
    - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_app/live
    - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_categories/live
    - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_site/live
    - /apis/v1/dataforseo/dataforseo_labs/google/page_intersection/live
    - /apis/v1/dataforseo/dataforseo_labs/google/ranked_keywords/live
    - /apis/v1/dataforseo/dataforseo_labs/google/related_keywords/live
    - /apis/v1/dataforseo/dataforseo_labs/google/relevant_pages/live
    - /apis/v1/dataforseo/dataforseo_labs/google/search_intent/live
    - /apis/v1/dataforseo/dataforseo_labs/google/serp_competitors/live
    - /apis/v1/dataforseo/dataforseo_labs/google/subdomains/live
    - /apis/v1/dataforseo/dataforseo_labs/google/top_searches/live
    - /apis/v1/dataforseo/dataforseo_labs/status
    - >-
      /apis/v1/dataforseo/domain_analytics/technologies/aggregation_technologies/live
    - /apis/v1/dataforseo/domain_analytics/technologies/available_filters
    - /apis/v1/dataforseo/domain_analytics/technologies/domain_technologies/live
    - >-
      /apis/v1/dataforseo/domain_analytics/technologies/domains_by_html_terms/live
    - >-
      /apis/v1/dataforseo/domain_analytics/technologies/domains_by_technology/live
    - /apis/v1/dataforseo/domain_analytics/technologies/languages
    - /apis/v1/dataforseo/domain_analytics/technologies/locations
    - /apis/v1/dataforseo/domain_analytics/technologies/technologies
    - >-
      /apis/v1/dataforseo/domain_analytics/technologies/technologies_summary/live
    - /apis/v1/dataforseo/domain_analytics/technologies/technology_stats/live
    - /apis/v1/dataforseo/domain_analytics/whois/available_filters
    - /apis/v1/dataforseo/domain_analytics/whois/overview/live
    - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/industries
    - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/job_functions
    - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/live
    - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_post
    - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/tasks_ready
    - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/live
    - >-
      /apis/v1/dataforseo/keywords_data/bing/keyword_performance/locations_and_languages
    - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_post
    - >-
      /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/languages
    - /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/live
    - >-
      /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_get/{id}
    - >-
      /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_post
    - >-
      /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/tasks_ready
    - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/live
    - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_post
    - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/live
    - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_post
    - /apis/v1/dataforseo/keywords_data/bing/languages
    - /apis/v1/dataforseo/keywords_data/bing/locations
    - /apis/v1/dataforseo/keywords_data/bing/search_volume/live
    - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_post
    - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/live
    - >-
      /apis/v1/dataforseo/keywords_data/bing/search_volume_history/locations_and_languages
    - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_post
    - /apis/v1/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live
    - >-
      /apis/v1/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live
    - >-
      /apis/v1/dataforseo/keywords_data/clickstream_data/global_search_volume/live
    - /apis/v1/dataforseo/keywords_data/clickstream_data/locations_and_languages
    - /apis/v1/dataforseo/keywords_data/dataforseo_trends/demography/live
    - /apis/v1/dataforseo/keywords_data/dataforseo_trends/explore/live
    - /apis/v1/dataforseo/keywords_data/dataforseo_trends/locations
    - /apis/v1/dataforseo/keywords_data/dataforseo_trends/merged_data/live
    - >-
      /apis/v1/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live
    - /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/live
    - >-
      /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}
    - >-
      /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post
    - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/live
    - >-
      /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_get/{id}
    - >-
      /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_post
    - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/live
    - >-
      /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_post
    - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/live
    - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_post
    - /apis/v1/dataforseo/keywords_data/google_ads/status
    - /apis/v1/dataforseo/keywords_data/google_trends/categories
    - /apis/v1/dataforseo/keywords_data/google_trends/explore/live
    - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_get/{id}
    - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_post
    - /apis/v1/dataforseo/merchant/amazon/asin/live/advanced
    - /apis/v1/dataforseo/merchant/amazon/asin/live/html
    - /apis/v1/dataforseo/merchant/amazon/asin/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/amazon/asin/task_get/html/{id}
    - /apis/v1/dataforseo/merchant/amazon/asin/task_post
    - /apis/v1/dataforseo/merchant/amazon/asin/tasks_ready
    - /apis/v1/dataforseo/merchant/amazon/languages
    - /apis/v1/dataforseo/merchant/amazon/locations
    - /apis/v1/dataforseo/merchant/amazon/products/live/advanced
    - /apis/v1/dataforseo/merchant/amazon/products/live/html
    - /apis/v1/dataforseo/merchant/amazon/products/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/amazon/products/task_get/html/{id}
    - /apis/v1/dataforseo/merchant/amazon/products/task_post
    - /apis/v1/dataforseo/merchant/amazon/products/tasks_ready
    - /apis/v1/dataforseo/merchant/amazon/sellers/live/advanced
    - /apis/v1/dataforseo/merchant/amazon/sellers/live/html
    - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/html/{id}
    - /apis/v1/dataforseo/merchant/amazon/sellers/task_post
    - /apis/v1/dataforseo/merchant/amazon/sellers/tasks_ready
    - /apis/v1/dataforseo/merchant/google/languages
    - /apis/v1/dataforseo/merchant/google/locations
    - /apis/v1/dataforseo/merchant/google/product_info/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/google/product_info/task_post
    - /apis/v1/dataforseo/merchant/google/product_info/tasks_ready
    - /apis/v1/dataforseo/merchant/google/products/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/google/products/task_get/html/{id}
    - /apis/v1/dataforseo/merchant/google/products/task_post
    - /apis/v1/dataforseo/merchant/google/products/tasks_ready
    - /apis/v1/dataforseo/merchant/google/reviews/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/google/reviews/task_post
    - /apis/v1/dataforseo/merchant/google/reviews/tasks_ready
    - /apis/v1/dataforseo/merchant/google/sellers/ad_url
    - /apis/v1/dataforseo/merchant/google/sellers/task_get/advanced/{id}
    - /apis/v1/dataforseo/merchant/google/sellers/task_post
    - /apis/v1/dataforseo/merchant/google/sellers/tasks_ready
    - /apis/v1/dataforseo/on_page/available_filters
    - /apis/v1/dataforseo/on_page/content_parsing
    - /apis/v1/dataforseo/on_page/content_parsing/live
    - /apis/v1/dataforseo/on_page/duplicate_content
    - /apis/v1/dataforseo/on_page/duplicate_tags
    - /apis/v1/dataforseo/on_page/force_stop
    - /apis/v1/dataforseo/on_page/instant_pages
    - /apis/v1/dataforseo/on_page/keyword_density
    - /apis/v1/dataforseo/on_page/lighthouse/audits
    - /apis/v1/dataforseo/on_page/lighthouse/languages
    - /apis/v1/dataforseo/on_page/lighthouse/live/json
    - /apis/v1/dataforseo/on_page/lighthouse/task_get/json/{id}
    - /apis/v1/dataforseo/on_page/lighthouse/task_post
    - /apis/v1/dataforseo/on_page/lighthouse/tasks_ready
    - /apis/v1/dataforseo/on_page/lighthouse/versions
    - /apis/v1/dataforseo/on_page/links
    - /apis/v1/dataforseo/on_page/microdata
    - /apis/v1/dataforseo/on_page/non_indexable
    - /apis/v1/dataforseo/on_page/page_screenshot
    - /apis/v1/dataforseo/on_page/pages
    - /apis/v1/dataforseo/on_page/pages_by_resource
    - /apis/v1/dataforseo/on_page/raw_html
    - /apis/v1/dataforseo/on_page/redirect_chains
    - /apis/v1/dataforseo/on_page/resources
    - /apis/v1/dataforseo/on_page/summary/{id}
    - /apis/v1/dataforseo/on_page/task_post
    - /apis/v1/dataforseo/on_page/tasks_ready
    - /apis/v1/dataforseo/on_page/uncrawlable_resources
    - /apis/v1/dataforseo/on_page/waterfall
    - /apis/v1/dataforseo/serp/ai_summary
    - /apis/v1/dataforseo/serp/baidu/languages
    - /apis/v1/dataforseo/serp/baidu/locations
    - /apis/v1/dataforseo/serp/baidu/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/baidu/organic/task_get/html/{id}
    - /apis/v1/dataforseo/serp/baidu/organic/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/baidu/organic/task_post
    - /apis/v1/dataforseo/serp/baidu/organic/tasks_ready
    - /apis/v1/dataforseo/serp/bing/languages
    - /apis/v1/dataforseo/serp/bing/locations
    - /apis/v1/dataforseo/serp/bing/organic/live/advanced
    - /apis/v1/dataforseo/serp/bing/organic/live/html
    - /apis/v1/dataforseo/serp/bing/organic/live/regular
    - /apis/v1/dataforseo/serp/bing/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/bing/organic/task_get/html/{id}
    - /apis/v1/dataforseo/serp/bing/organic/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/bing/organic/task_post
    - /apis/v1/dataforseo/serp/bing/organic/tasks_ready
    - /apis/v1/dataforseo/serp/google/ads_advertisers/live/advanced
    - /apis/v1/dataforseo/serp/google/ads_advertisers/locations
    - /apis/v1/dataforseo/serp/google/ads_advertisers/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/ads_advertisers/task_post
    - /apis/v1/dataforseo/serp/google/ads_advertisers/tasks_ready
    - /apis/v1/dataforseo/serp/google/ads_search/live/advanced
    - /apis/v1/dataforseo/serp/google/ads_search/locations
    - /apis/v1/dataforseo/serp/google/ads_search/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/ads_search/task_post
    - /apis/v1/dataforseo/serp/google/ads_search/tasks_ready
    - /apis/v1/dataforseo/serp/google/ai_mode/languages
    - /apis/v1/dataforseo/serp/google/ai_mode/live/advanced
    - /apis/v1/dataforseo/serp/google/ai_mode/live/html
    - /apis/v1/dataforseo/serp/google/ai_mode/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/ai_mode/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/ai_mode/task_post
    - /apis/v1/dataforseo/serp/google/ai_mode/tasks_ready
    - /apis/v1/dataforseo/serp/google/autocomplete/live/advanced
    - /apis/v1/dataforseo/serp/google/autocomplete/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/autocomplete/task_post
    - /apis/v1/dataforseo/serp/google/autocomplete/tasks_ready
    - /apis/v1/dataforseo/serp/google/dataset_info/live/advanced
    - /apis/v1/dataforseo/serp/google/dataset_info/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/dataset_info/task_post
    - /apis/v1/dataforseo/serp/google/dataset_info/tasks_ready
    - /apis/v1/dataforseo/serp/google/dataset_search/live/advanced
    - /apis/v1/dataforseo/serp/google/dataset_search/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/dataset_search/task_post
    - /apis/v1/dataforseo/serp/google/dataset_search/tasks_ready
    - /apis/v1/dataforseo/serp/google/events/live/advanced
    - /apis/v1/dataforseo/serp/google/events/locations
    - /apis/v1/dataforseo/serp/google/events/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/events/task_post
    - /apis/v1/dataforseo/serp/google/events/tasks_ready
    - /apis/v1/dataforseo/serp/google/finance_explore/live/advanced
    - /apis/v1/dataforseo/serp/google/finance_explore/live/html
    - /apis/v1/dataforseo/serp/google/finance_explore/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/finance_explore/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/finance_explore/task_post
    - /apis/v1/dataforseo/serp/google/finance_explore/tasks_ready
    - /apis/v1/dataforseo/serp/google/finance_markets/live/advanced
    - /apis/v1/dataforseo/serp/google/finance_markets/live/html
    - /apis/v1/dataforseo/serp/google/finance_markets/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/finance_markets/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/finance_markets/task_post
    - /apis/v1/dataforseo/serp/google/finance_markets/tasks_ready
    - /apis/v1/dataforseo/serp/google/finance_quote/live/advanced
    - /apis/v1/dataforseo/serp/google/finance_quote/live/html
    - /apis/v1/dataforseo/serp/google/finance_quote/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/finance_quote/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/finance_quote/task_post
    - /apis/v1/dataforseo/serp/google/finance_quote/tasks_ready
    - /apis/v1/dataforseo/serp/google/finance_ticker_search/live/advanced
    - >-
      /apis/v1/dataforseo/serp/google/finance_ticker_search/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/finance_ticker_search/task_post
    - /apis/v1/dataforseo/serp/google/finance_ticker_search/tasks_ready
    - /apis/v1/dataforseo/serp/google/images/live/advanced
    - /apis/v1/dataforseo/serp/google/images/live/html
    - /apis/v1/dataforseo/serp/google/images/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/images/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/images/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/google/images/task_post
    - /apis/v1/dataforseo/serp/google/images/tasks_ready
    - /apis/v1/dataforseo/serp/google/jobs/locations
    - /apis/v1/dataforseo/serp/google/jobs/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/jobs/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/jobs/task_post
    - /apis/v1/dataforseo/serp/google/jobs/tasks_ready
    - /apis/v1/dataforseo/serp/google/languages
    - /apis/v1/dataforseo/serp/google/local_finder/live/advanced
    - /apis/v1/dataforseo/serp/google/local_finder/live/html
    - /apis/v1/dataforseo/serp/google/local_finder/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/local_finder/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/local_finder/task_post
    - /apis/v1/dataforseo/serp/google/local_finder/tasks_ready
    - /apis/v1/dataforseo/serp/google/locations
    - /apis/v1/dataforseo/serp/google/maps/live/advanced
    - /apis/v1/dataforseo/serp/google/maps/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/maps/task_post
    - /apis/v1/dataforseo/serp/google/maps/tasks_ready
    - /apis/v1/dataforseo/serp/google/news/live/advanced
    - /apis/v1/dataforseo/serp/google/news/live/html
    - /apis/v1/dataforseo/serp/google/news/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/news/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/news/task_post
    - /apis/v1/dataforseo/serp/google/news/tasks_ready
    - /apis/v1/dataforseo/serp/google/organic/live/advanced
    - /apis/v1/dataforseo/serp/google/organic/live/html
    - /apis/v1/dataforseo/serp/google/organic/live/regular
    - /apis/v1/dataforseo/serp/google/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/organic/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/organic/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/google/organic/task_post
    - /apis/v1/dataforseo/serp/google/organic/tasks_ready
    - /apis/v1/dataforseo/serp/google/search_by_image/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/google/search_by_image/task_get/html/{id}
    - /apis/v1/dataforseo/serp/google/search_by_image/task_post
    - /apis/v1/dataforseo/serp/google/search_by_image/tasks_ready
    - /apis/v1/dataforseo/serp/naver/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/naver/organic/task_get/html/{id}
    - /apis/v1/dataforseo/serp/naver/organic/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/naver/organic/task_post
    - /apis/v1/dataforseo/serp/naver/organic/tasks_ready
    - /apis/v1/dataforseo/serp/screenshot
    - /apis/v1/dataforseo/serp/seznam/languages
    - /apis/v1/dataforseo/serp/seznam/locations
    - /apis/v1/dataforseo/serp/seznam/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/seznam/organic/task_get/html/{id}
    - /apis/v1/dataforseo/serp/seznam/organic/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/seznam/organic/task_post
    - /apis/v1/dataforseo/serp/seznam/organic/tasks_ready
    - /apis/v1/dataforseo/serp/yahoo/languages
    - /apis/v1/dataforseo/serp/yahoo/locations
    - /apis/v1/dataforseo/serp/yahoo/organic/live/advanced
    - /apis/v1/dataforseo/serp/yahoo/organic/live/html
    - /apis/v1/dataforseo/serp/yahoo/organic/live/regular
    - /apis/v1/dataforseo/serp/yahoo/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/yahoo/organic/task_get/html/{id}
    - /apis/v1/dataforseo/serp/yahoo/organic/task_get/regular/{id}
    - /apis/v1/dataforseo/serp/yahoo/organic/task_post
    - /apis/v1/dataforseo/serp/yahoo/organic/tasks_ready
    - /apis/v1/dataforseo/serp/youtube/languages
    - /apis/v1/dataforseo/serp/youtube/locations
    - /apis/v1/dataforseo/serp/youtube/organic/live/advanced
    - /apis/v1/dataforseo/serp/youtube/organic/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/youtube/organic/task_post
    - /apis/v1/dataforseo/serp/youtube/organic/tasks_ready
    - /apis/v1/dataforseo/serp/youtube/video_comments/live/advanced
    - /apis/v1/dataforseo/serp/youtube/video_comments/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/youtube/video_comments/task_post
    - /apis/v1/dataforseo/serp/youtube/video_comments/tasks_ready
    - /apis/v1/dataforseo/serp/youtube/video_info/live/advanced
    - /apis/v1/dataforseo/serp/youtube/video_info/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/youtube/video_info/task_post
    - /apis/v1/dataforseo/serp/youtube/video_info/tasks_ready
    - /apis/v1/dataforseo/serp/youtube/video_subtitles/live/advanced
    - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_get/advanced/{id}
    - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_post
    - /apis/v1/dataforseo/serp/youtube/video_subtitles/tasks_ready
  x-aisa-document:
    facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c
    generator_version: '3'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '20'
    response_pending: []
    document_hash: sha256:247f0a53489bda2c81b4142a1275f7af13128904396e39f2485c6ba921e0d40a
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: dataforseo
  x-aisa-catalogs:
    dataforseo:
      title: DataForSEO
      description: ''
      x-aisa-document:
        facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c
        generator_version: '3'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live:
    post:
      tags:
        - default
      summary: Live Ai Optimization Llm Mentions Multi Target Metrics
      description: >-
        DataForSEO POST
        /v3/ai_optimization/llm_mentions/multi_target_metrics/live


        <!-- aisa-pricing:start -->

        Usage-based billing; Default request estimate: $0.101 USD (not a fixed
        price). Account-specific pricing and final settlement may differ.

        <!-- aisa-pricing:end -->
      operationId: any_dataforseo_apis_v1_dataforseo_ai_optimization_5d5a92
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                  - object
                  - 'null'
                oneOf:
                  - type: object
                    properties:
                      targets:
                        type:
                          - array
                          - 'null'
                        items:
                          type:
                            - object
                            - 'null'
                          oneOf:
                            - type: object
                              properties:
                                target:
                                  type:
                                    - array
                                    - 'null'
                                  items:
                                    type:
                                      - object
                                      - 'null'
                                    oneOf:
                                      - type: object
                                        properties:
                                          search_scope:
                                            type:
                                              - array
                                              - 'null'
                                            items:
                                              type:
                                                - string
                                                - 'null'
                                            description: |-
                                              target domain search scope
                                              optional field
                                              possible values:
                                              any, sources, search_results
                                              default value: any
                                          search_filter:
                                            type:
                                              - string
                                              - 'null'
                                            description: |-
                                              target domain search filter
                                              optional field
                                              possible values:
                                              include, exclude
                                              default value: include
                                        discriminator:
                                          propertyName: type
                                          mapping:
                                            domain: >-
                                              #/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsDomainElement
                                            keyword: >-
                                              #/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsKeywordElement
                                key:
                                  type:
                                    - string
                                    - 'null'
                                  description: >-
                                    key for grouping the results

                                    required field

                                    groups results for comparison and serves as
                                    a label for the group;

                                    you can specify up to 250 characters in the
                                    key field
                      location_name:
                        type:
                          - string
                          - 'null'
                        description: >-
                          <em>full name of search location</em><br>optional
                          field<br>if you use this field, you don't need to
                          specify <code>location_code</code><br>if you don't
                          specify this field, the <code>location_code</code>
                          with <code class="long-string">2840</code> value will
                          be used by default;<br>you can receive the list of
                          available locations of the search engine with their
                          <code>location_name</code> by making a separate
                          request to the
                          <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br><strong>Note:
                          <code>chat_gpt</code> data is available for <code
                          class="long-string">United States</code> only
                      location_code:
                        type:
                          - integer
                          - 'null'
                        description: >-
                          <em>search location code</em><br>optional field<br>if
                          you use this field, you don't need to specify
                          <code>location_name</code><br>you can receive the list
                          of available locations of the search engine with their
                          <code>location_code</code> by making a separate
                          request to the
                          <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br>default
                          value: <code
                          class="long-string">2840</code><br><strong>Note:
                          <code>chat_gpt</code> data is available for <code
                          class="long-string">2840</code> only
                      language_name:
                        type:
                          - string
                          - 'null'
                        description: >-
                          <em>full name of search language</em><br>optional
                          field<br>if you use this field, you don't need to
                          specify <code>language_code</code>;<br>if you don't
                          specify this field, the <code>language_code</code>
                          with <code class="long-string">en</code> value will be
                          used by default;<br>you can receive the list of
                          available languages of the search engine with their
                          <code>language_name</code> by making a separate
                          request to the
                          <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br><strong>Note:
                          <code>chat_gpt</code> data is available for <code
                          class="long-string">English</code> only
                      language_code:
                        type:
                          - string
                          - 'null'
                        description: >-
                          <em>search language code</em><br>optional field<br>if
                          you use this field, you don't need to specify
                          <code>language_name</code>;<br>you can receive the
                          list of available languages of the search engine with
                          their <code>language_code</code> by making a separate
                          request to the
                          <code>https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages</code><br>default
                          value: <code
                          class="long-string">en</code><br><strong>Note:
                          <code>chat_gpt</code> data is available for <code
                          class="long-string">en</code> only
                      platform:
                        type:
                          - string
                          - 'null'
                        description: >-
                          <em>target platform</em><br>optional field<br>possible
                          values:<br><code>chat_gpt</code>,
                          <code>google</code><br>default value: <code
                          class="long-string">google</code><br><strong>Note:</strong>
                          if the <code>platform</code> is not specified, the
                          data is returned for both platforms<br><strong>Note
                          #2:</strong><code>chat_gpt</code> data is available
                          for the <code>United States</code> and
                          <code>English</code> only
                      filters:
                        type:
                          - array
                          - 'null'
                        items:
                          type:
                            - object
                            - 'null'
                        description: >-
                          <em>array of results filtering
                          parameters</em><br>optional field<br><strong>you can
                          add several filters at once (8 filters
                          maximum)</strong><br>you should set a logical operator
                          <code>and</code>, <code>or</code> between the
                          conditions<br>the following operators are
                          supported:<br><code>=</code>, <code>&lt;&gt;</code>,
                          <code>in</code>, <code>not_in</code>,
                          <code>like</code>, <code>not_like</code>,
                          <code>ilike</code>, <code>not_ilike</code>,
                          <code>match</code>, <code>not_match</code><br>you can
                          use the <code>%</code> operator with <code>like</code>
                          and <code>not_like</code> to match any string of zero
                          or more
                          characters<br>example:<br><code>["ai_search_volume","&gt;",1000]</code><p>The
                          full list of possible filters is available <a
                          href="/v3/ai_optimization/llm_mentions/filters/"
                          rel="noopener noreferrer" target="_blank">here.</a>
                      initial_dataset_filters:
                        type:
                          - array
                          - 'null'
                        items:
                          type:
                            - object
                            - 'null'
                        description: >-
                          <em>array of filter expressions applied before
                          aggregation</em><br>optional field<br>you can use this
                          array to filter expressions applied to the raw
                          mentions database before aggregation to limit the rows
                          contributing to the result;<p><strong>you can add
                          several filters at once (8 filters
                          maximum)</strong><br>you should set a logical operator
                          <code>and</code>, <code>or</code> between the
                          conditions<br>the following operators are
                          supported:<br><code>=</code>, <code>&lt;&gt;</code>,
                          <code>in</code>, <code>not_in</code>,
                          <code>like</code>, <code>not_like</code>,
                          <code>ilike</code>, <code>not_ilike</code>,
                          <code>match</code>, <code>not_match</code><br>you can
                          use the <code>%</code> operator with <code>like</code>
                          and <code>not_like</code> to match any string of zero
                          or more
                          characters<br>example:<br><code>["ai_search_volume","&gt;",1000]</code><p>the
                          full list of possible filters is available <a
                          href="/v3/ai_optimization/llm_mentions/filters"
                          rel="noopener noreferrer"
                          target="_blank">here.</a><br>learn more about the
                          initial dataset filters in <a
                          href="https://dataforseo.com/help-center/what-are-the-initial-dataset-filters-and-how-do-they-work"
                          rel="noopener noreferrer" target="_blank">this help
                          center article.</a>
                      order_by:
                        type:
                          - array
                          - 'null'
                        items:
                          type: string
                        description: >-
                          <em>results sorting rules</em><br>optional
                          field<br>you can use the same values as in the
                          <code>filters</code> array to sort the
                          results<br>possible sorting types:<br><code>asc</code>
                          - results will be sorted in the ascending
                          order<br><code>desc</code> - results will be sorted in
                          the descending order<br>you should use a comma to set
                          up a sorting
                          type<br>example:<br><code>["ai_search_volume,desc"]</code><br><strong>Note:</strong>
                          you can set no more than three sorting rules in a
                          single request<br>you should use a comma to separate
                          several sorting rules
                      limit:
                        type:
                          - integer
                          - 'null'
                        description: >-
                          <em>the maximum number of returned
                          objects</em><br>optional field<p>default value:
                          <code>100</code><br>maximum value: <code>1000</code>
                      offset:
                        type:
                          - integer
                          - 'null'
                        description: >-
                          <em>offset in the results array of the returned
                          mentions data</em><br>optional field<p>default value:
                          <code>0</code><br>example: if you specify the
                          <code>10</code> value, the first ten mentions objects
                          in the results array will be omitted and the data will
                          be provided for the successive
                          objects;<br><strong>Note:</strong> the maximum value
                          is <code>1000000</code>, use the
                          <code>search_after_token</code> if you would like to
                          offset more results
                      internal_list_limit:
                        type:
                          - integer
                          - 'null'
                        description: >-
                          <em>maximum number of elements within internal
                          arrays</em><br>optional field<br>you can use this
                          field to limit the number of elements within the
                          following
                          arrays:<br><code>sources_domain</code><br><code>search_results_domain</code><br>minimum
                          value: <code>1</code><br>maximum value:
                          <code>10</code><br>default value: <code>5</code>
                      tag:
                        type:
                          - string
                          - 'null'
                        description: >-
                          <em>user-defined task identifier</em><br>optional
                          field<br><em>the character limit is 255</em><br>you
                          can use this parameter to identify the task and match
                          it with the result<br>you will find the specified
                          <code>tag</code> value in the <code>data</code> object
                          of the response
                    example:
                      - language_code: en
                        location_code: 2840
                        platform: google
                        targets:
                          - key: chat_gpt
                            target:
                              - keyword: chat gpt
                          - key: claude
                            target:
                              - keyword: claude
                          - key: gemini
                            target:
                              - keyword: gemini
                          - key: perplexity
                            target:
                              - keyword: perplexity
                                search_filter: include
                        initial_dataset_filters:
                          - - ai_search_volume
                            - '>'
                            - 10
                        internal_list_limit: 5
              example:
                - language_code: en
                  location_code: 2840
                  platform: google
                  targets:
                    - key: chat_gpt
                      target:
                        - keyword: chat gpt
                    - key: claude
                      target:
                        - keyword: claude
                    - key: gemini
                      target:
                        - keyword: gemini
                    - key: perplexity
                      target:
                        - keyword: perplexity
                          search_filter: include
                  initial_dataset_filters:
                    - - ai_search_volume
                      - '>'
                      - 10
                  internal_list_limit: 5
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                  - object
                  - 'null'
                oneOf:
                  - $ref: >-
                      #/components/schemas/Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveResponseInfo
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
      x-codeSamples:
        - lang: text
          label: Reference example
          source: >-
            # Fixed reference example. Playground inputs do not update this
            sample.

            curl --request POST \
              --url https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live \
              --header 'Authorization: Bearer <token>' \
              --header 'Content-Type: application/json' \
              --data '[
              {
                "language_code": "en",
                "location_code": 2840,
                "platform": "google",
                "targets": [
                  {
                    "key": "chat_gpt",
                    "target": [
                      {
                        "keyword": "chat gpt"
                      }
                    ]
                  },
                  {
                    "key": "claude",
                    "target": [
                      {
                        "keyword": "claude"
                      }
                    ]
                  },
                  {
                    "key": "gemini",
                    "target": [
                      {
                        "keyword": "gemini"
                      }
                    ]
                  },
                  {
                    "key": "perplexity",
                    "target": [
                      {
                        "keyword": "perplexity",
                        "search_filter": "include"
                      }
                    ]
                  }
                ],
                "initial_dataset_filters": [
                  [
                    "ai_search_volume",
                    ">",
                    10
                  ]
                ],
                "internal_list_limit": 5
              }
            ]'
components:
  schemas:
    Provider463397119C53_AiOptimizationLLmMentionsDomainElement:
      allOf:
        - type:
            - object
            - 'null'
          oneOf:
            - $ref: >-
                #/components/schemas/Provider463397119C53_BaseAiOptimizationLLmMentionsTargetElement
        - type: object
          properties:
            domain:
              type:
                - string
                - 'null'
              description: |-
                target domain
                required field if you don’t specify keyword
                a domain should be specified without https:// and www.
            include_subdomains:
              type:
                - boolean
                - 'null'
              description: >-
                indicates if the subdomains of the target domain will be
                included in the search

                optional field

                if set to true, the subdomains will be included in the search

                default value: false
    Provider463397119C53_AiOptimizationLLmMentionsKeywordElement:
      allOf:
        - type:
            - object
            - 'null'
          oneOf:
            - $ref: >-
                #/components/schemas/Provider463397119C53_BaseAiOptimizationLLmMentionsTargetElement
        - type: object
          properties:
            keyword:
              type:
                - string
                - 'null'
              description: >-
                target keyword

                required field if you don’t specify domain

                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
            match_type:
              type:
                - string
                - 'null'
              description: >-
                target keyword match type

                defines how the specified keyword is matched

                optional field

                possible values:

                word_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”);

                partial_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”);

                default value: word_match
    Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveResponseInfo:
      type: object
      allOf:
        - $ref: '#/components/schemas/Response463397119C53_BaseResponseInfo'
        - type: object
          properties:
            tasks:
              type:
                - array
                - 'null'
              items:
                type:
                  - object
                  - 'null'
                oneOf:
                  - $ref: >-
                      #/components/schemas/Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveTaskInfo
              description: <em>array of tasks</em>
    Provider463397119C53_BaseAiOptimizationLLmMentionsTargetElement:
      type: object
      properties:
        search_scope:
          type:
            - array
            - 'null'
          items:
            type:
              - string
              - 'null'
          description: |-
            target domain search scope
            optional field
            possible values:
            any, sources, search_results
            default value: any
        search_filter:
          type:
            - string
            - 'null'
          description: |-
            target domain search filter
            optional field
            possible values:
            include, exclude
            default value: include
      discriminator:
        propertyName: type
        mapping:
          domain: >-
            #/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsDomainElement
          keyword: >-
            #/components/schemas/Provider463397119C53_AiOptimizationLLmMentionsKeywordElement
    Response463397119C53_BaseResponseInfo:
      properties:
        version:
          type:
            - string
            - 'null'
          description: the current version of the API
        status_code:
          type:
            - integer
            - 'null'
          description: |-
            general status code
            you can find the full list of the response codes here
        status_message:
          type:
            - string
            - 'null'
          description: |-
            general informational message
            you can find the full list of general informational messages here
        time:
          type:
            - string
            - 'null'
          description: total execution time, seconds
        cost:
          type:
            - number
            - 'null'
          description: total tasks cost, USD
          format: double
        tasks_count:
          type:
            - integer
            - 'null'
          description: the number of tasks in the tasks array
          format: int64
        tasks_error:
          type:
            - integer
            - 'null'
          description: the number of tasks in the tasks array returned with an error
          format: int64
    Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveTaskInfo:
      type: object
      allOf:
        - $ref: '#/components/schemas/Response463397119C53_BaseResponseTaskInfo'
        - type: object
          properties:
            result:
              type:
                - array
                - 'null'
              items:
                type:
                  - object
                  - 'null'
                oneOf:
                  - $ref: >-
                      #/components/schemas/Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveResultInfo
              description: <em>array of results</em>
    Response463397119C53_BaseResponseTaskInfo:
      properties:
        id:
          type:
            - string
            - 'null'
          description: |-
            task identifier
            unique task identifier in our system in the UUID format
        status_code:
          type:
            - integer
            - 'null'
          description: >-
            status code of the task

            generated by DataForSEO, can be within the following range:
            10000-60000

            you can find the full list of the response codes here
        status_message:
          type:
            - string
            - 'null'
          description: |-
            informational message of the task
            you can find the full list of general informational messages here
        time:
          type:
            - string
            - 'null'
          description: execution time, seconds
        cost:
          type:
            - number
            - 'null'
          description: total tasks cost, USD
          format: double
        result_count:
          type:
            - integer
            - 'null'
          description: number of elements in the result array
          format: int64
        path:
          type:
            - array
            - 'null'
          items:
            type:
              - string
              - 'null'
          description: URL path
        data:
          type:
            - object
            - 'null'
          additionalProperties:
            type:
              - object
              - 'null'
          description: contains the same parameters that you specified in the POST request
    Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveResultInfo:
      type: object
      properties:
        total_count:
          type:
            - integer
            - 'null'
          description: <em>total number of results</em>
          format: int64
        offset:
          type:
            - integer
            - 'null'
          description: >-
            <em>offset in the results array of the returned mentions
            data</em><br><code>offset</code> specified in the request
        items_count:
          type:
            - integer
            - 'null'
          description: <em>number of items in the results array</em>
          format: int64
        aggregated_metrics:
          type:
            - object
            - 'null'
          oneOf:
            - $ref: >-
                #/components/schemas/Response463397119C53_LlmMentionsAggregatedMetricsInfo
          description: >-
            <em>aggregated mentions metrics summary</em><br>contains overall
            aggregated LLM mention metrics across all LLM mentions that match at
            least one target specified in the request
        items:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveItem
          description: <em>contains relevant mentions data</em>
    Response463397119C53_LlmMentionsAggregatedMetricsInfo:
      type: object
      properties:
        location:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>location-based grouping</em><br>array of objects containing
            mention metrics segmented by geographical location
        language:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>language-based grouping</em><br>array of objects containing
            mention metrics segmented by content language
        platform:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>platform-based grouping</em><br>array of group elements
            containing mention metrics segmented by AI platform
        sources_domain:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>found top source domains relevant to the target</em><br>array of
            objects containing data on top domains that are cited as sources in
            LLM responses<br>learn more about the sources and how to retrieve
            LLM citation data at our <a
            href="https://dataforseo.com/help-center/how-to-get-llm-citation-data-with-llm-mentions-api"
            target="_blank">Help Center</a>
        search_results_domain:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>found top search results domains relevant to the
            target</em><br>array of objects containing data on top domains that
            appear in search results related to LLM
            queries;<br><strong>Note:</strong> available only for
            <code>chat_gpt</code>
        brand_entities_title:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>data on brand entities relevant to the target</em><br>array of
            objects containing data on brand entity titles that appear in search
            results related to LLM queries;<br><strong>Note:</strong> available
            only for <code>chat_gpt</code>
        brand_entities_category:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>data on brand entities relevant to the target</em><br>array of
            objects containing data on brand entity categories that appear in
            search results related to LLM queries<br><strong>Note:</strong>
            available only for <code>chat_gpt</code>
        total:
          type:
            - object
            - 'null'
          oneOf:
            - $ref: >-
                #/components/schemas/Response463397119C53_AggregatedMetricsInfoTotalInfo
          description: >-
            <em>aggregated mentions metrics summary</em><br>contains overall
            aggregated LLM mention metrics across all found domains
    Response463397119C53_AiOptimizationLlmMentionsMultiTargetMetricsLiveItem:
      type: object
      properties:
        key:
          type:
            - string
            - 'null'
          description: >-
            <em>grouping key</em><br>the specific identifier for the group
            dimension
        location:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>location-based grouping</em><br>array of objects containing
            mention metrics segmented by geographical location
        language:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>language-based grouping</em><br>array of objects containing
            mention metrics segmented by content language
        platform:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>platform-based grouping</em><br>array of group elements
            containing mention metrics segmented by AI platform
        sources_domain:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>found top source domains relevant to the target</em><br>array of
            objects containing data on top domains that are cited as sources in
            LLM responses<br>learn more about the sources and how to retrieve
            LLM citation data at our <a
            href="https://dataforseo.com/help-center/how-to-get-llm-citation-data-with-llm-mentions-api"
            target="_blank">Help Center</a>
        search_results_domain:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>found top search results domains relevant to the
            target</em><br>array of objects containing data on top domains that
            appear in search results related to LLM
            queries;<br><strong>Note:</strong> available only for
            <code>chat_gpt</code>
        brand_entities_title:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>data on brand entities relevant to the target</em><br>array of
            objects containing data on brand entity titles that appear in search
            results related to LLM queries<br><strong>Note:</strong> available
            only for <code>chat_gpt</code>
        brand_entities_category:
          type:
            - array
            - 'null'
          items:
            type:
              - object
              - 'null'
            oneOf:
              - $ref: >-
                  #/components/schemas/Response463397119C53_AggregatedMetricsItemInfo
          description: >-
            <em>data on brand entities relevant to the target</em><br>array of
            objects containing data on brand entity categories that appear in
            search results related to LLM queries;<br><strong>Note:</strong>
            available only for <code>chat_gpt</code>
        total:
          type:
            - object
            - 'null'
          oneOf:
            - $ref: >-
                #/components/schemas/Response463397119C53_AggregatedMetricsInfoTotalInfo
          description: <em>data on total mentions and search volume for the target</em>
    Response463397119C53_AggregatedMetricsItemInfo:
      type: object
      properties:
        key:
          type:
            - string
            - 'null'
          description: >-
            <em>grouping identifier</em><br>the specific identifier for the
            grouping dimension
        mentions:
          type:
            - integer
            - 'null'
          description: >-
            <em>total LLM mentions count</em><br>the number of times the target
            keyword or domain were mentioned in relation to this specific
            grouping key
        ai_search_volume:
          type:
            - integer
            - 'null'
          description: >-
            <em>aggregated AI search volume for mentions within this
            grouping</em><br>learn more about this metric <a
            href="https://dataforseo.com/help-center/how-the-ai-search-volume-metric-works-in-llm-mentions"
            rel="noopener noreferrer" target="_blank">here</a>
          format: int64
    Response463397119C53_AggregatedMetricsInfoTotalInfo:
      type: object
      properties:
        mentions:
          type:
            - integer
            - 'null'
          description: >-
            <em>total LLM mentions count</em><br>the number of times the target
            keyword or domain were mentioned in relation to this specific
            grouping key
        ai_search_volume:
          type:
            - integer
            - 'null'
          description: >-
            <em>aggregated AI search volume for mentions within this
            grouping</em><br>learn more about this metric <a
            href="https://dataforseo.com/help-center/how-the-ai-search-volume-metric-works-in-llm-mentions"
            rel="noopener noreferrer" target="_blank">here</a>
          format: int64
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.