AI Search: Get Prompts by Brand (SE Ranking)
DATA_getAiPromptsByBrandRetrieve AI search prompts mentioning a brand to track brand visibility across LLMs. Filter by engine, region, volume, and keywords.
Instructions
Data Tool: Retrieves a list of prompts where the specified brand is mentioned in AI search results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | The field to sort the results by. Options: volume, type, snippet_length. | volume |
| brand | Yes | Brand name to search for in LLM snippets. | |
| limit | No | Max prompts per page (1–1000). Default: 100. | |
| engine | Yes | LLM to query (e.g., 'ai-overview', 'chatgpt', 'perplexity', 'gemini', 'ai-mode'). | |
| offset | No | Starting index for pagination. Default: 0. | |
| source | Yes | Alpha-2 country code of the regional prompt database (e.g., 'us'). | |
| sort_order | No | Sort direction. Default: desc. | desc |
| filter_volume_to | No | Specifies the maximum volume of searches to be included in the results. | |
| filter_volume_from | No | Specifies the minimum volume of searches to be included in the results. | |
| filter_keyword_count_to | No | Specifies the maximum number of words in prompts. | |
| filter_keyword_count_from | No | Specifies the minimum number of words in prompts. | |
| filter_characters_count_to | No | Specifies the maximum prompt length in characters. | |
| filter_characters_count_from | No | Specifies the minimum prompt length in characters. | |
| filter_multi_keyword_excluded | No | A URL-encoded JSON string specifying keywords that must NOT be present in the prompt. For example: filter[multi_keyword_excluded]=[[{"type":"contains","value":"seo"},{"type":"contains","value":"tools"}],[{"type":"contains","value":"backlinks"}]] | |
| filter_multi_keyword_included | No | A URL-encoded JSON string specifying keywords that must be present in the prompt. For example: filter[multi_keyword_included]=[[{"type":"contains","value":"seo"},{"type":"contains","value":"tools"}],[{"type":"contains","value":"backlinks"}]] |