AI Search: Get Prompts by Target (SE Ranking)
aiSearchPromptsByTargetRetrieve prompts from AI search engines that mention a specific domain or URL, enabling analysis of brand visibility and context in LLM responses.
Instructions
Fetch the list of prompts (queries) that refer to or mention a given target (domain/URL) in the AI Search context. Corresponds to SE Ranking’s “Get Prompts by Target” API section.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| engine | Yes | Type of LLM engine (e.g. 'chatgpt', 'perplexity', 'ai-mode', etc.). | |
| target | Yes | The target to retrieve prompts for (domain, host, or URL). | |
| source | Yes | Alpha-2 country code of the regional prompt database (e.g. 'US'). | |
| scope | No | Scope of analysis: base_domain (the root domain only), domain (the domain including all subdomains), or url (an exact URL). | base_domain |
| sort | No | The field to sort the results by. Options: volume, type, snippet_length. | volume |
| sort_order | No | Sort order ('asc' for ascending, 'desc' for descending). Default is 'desc'. | desc |
| limit | No | Maximum number of prompts to return. | |
| offset | No | Offset for pagination (starting index). | |
| filter[volume][from] | No | Specifies the minimum volume of searches to be included in the results. | |
| filter[volume][to] | No | Specifies the maximum volume of searches to be included in the results. | |
| filter[keyword_count][from] | No | Specifies the minimum number of words in prompts. | |
| filter[keyword_count][to] | No | Specifies the maximum number of words in prompts. | |
| filter[characters_count][from] | No | Specifies the minimum prompt length in characters. | |
| filter[characters_count][to] | No | Specifies the maximum prompt length in characters. | |
| 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"}]] | |
| 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"}]] |