Custom queries lets you set a customized question or prompt that you can monitor AI responses for, in addition to the global Ahrefs AI prompt dataset. You can choose the AI Assistant(s) / LLM(s), as well as how frequently to refresh the generated response.
The AI Assistants / LLMs that you can check custom prompts for are:
ChatGPT
Perplexity
Gemini
Copilot
You can check custom queries monthly, weekly, or daily. Or you can turn off any of the AI assistants that gets checked.
What do I need to purchase to use custom queries?
You'd need to purchase the full Brand Radar add-on (for now).
If you have this add on, you can perform 2,500 checks/mo.
1 check is calculated as: 1 prompt execution × 1 LLM × 1 location.
If you exceed this number per month, you can purchase more at an overage rate $0.020/check for any platform.
By purchasing a prepaid package, you can increase your monthly checks at a reduced overage rate:
You can check the amount of checks that your current plan has, how much has been consumed in the current billing month, and purchase additional prepaid packages from your Account settings > Limits and usage:
How to set up custom queries
You first need to set up a Brand Radar report that is attached to a project. If a report is not attached to a project, you can click on “Custom queries” under Configure from the sidebar and a window will open with an option to attach a project to the current report.
A Brand Radar report can be attached to any project to start tracking custom queries, but only 1 report can be attached to 1 project at a time.
Once the current report is attached to a report, you'll see the option to "Add queries":
You can add one query per line. You can also set one or more locations for the check to be conducted:
The total number of estimated checks can be found just above the Add queries button. Please remember to review the additional checks that will be consumed by adding these custom queries.
Once these custom queries added, you will see them, and other previously added custom queries in the main page.
On this page, you can add more, or select existing custom queries to be deleted. Please note that deleting custom queries is not reversible.
How long will it take for custom queries to be prompted in AI assistants/LLMs?
Once custom queries are newly added, it can take up to 24 hours for the AI response data to be visible in the Brand Radar reports. If you don't see the custom queries data being updated after 24 hours, please contact our support team.
How to view the responses of custom queries
Once custom queries are added to your report, you can view them alongside all other data in the AI prompt dataset from the Overview, and AI Visibility pages:
You will also see an optional "Dataset" filter in the top left to filter either for Ahrefs queries only, or Custom queries. When none is selected, both data sources will be present in the report:
