Check Ahrefs usage before a research batch
Capture an explicit usage-check button in a bot message in Telegram and get current Ahrefs subscription limits and usage without losing the thread. This reads quota; it cannot raise limits or reserve credits.
Trigger
Callback Query Received
Triggered when a user taps an inline keyboard button attached to one of your bot's messages.
Action
Retrieve subscription limits and usage
Retrieves detailed information about the current subscription limits and usage for an ahrefs account. this endpoint provides essential data to monitor api consumption, track remaining credits or rows, and manage subscription usage effectively. it should be used regularly to ensure compliance with plan limits and to plan for potential upgrades or additional purchases. the tool does not modify any account settings or usage data; it only provides a snapshot of the current status. while specific response fields are not detailed in the schema, users can expect information about total limits, current usage, and possibly remaining allowances for various ahrefs features and api endpoints.
Why this helps
Check Ahrefs usage before a research batch otherwise requires leaving Telegram, reopening Ahrefs, and reconstructing the original context.
- Retrieve current Ahrefs subscription limits and usage from the source context.
- Keep the analysis and its caveat in the Telegram run report.
Setup
Build it in a few focused steps.
- 1Connect Telegram and Ahrefs to Notis once in the portal.
- 2Ask Notis to create this automation, or open Automations → New Automation and enter a name plus this prompt: “When a button tap provides an explicit usage-check button in a bot message, use Ahrefs to retrieve current Ahrefs subscription limits and usage. Report the result in Telegram with the source target and a short interpretation. This reads quota; it cannot raise limits or reserve credits. Ignore unrelated messages.”
- 3Select the Telegram Callback Query Received trigger and choose Telegram as the run-report channel.
- 4Test with one real button tap containing an explicit usage-check button in a bot message; review the Ahrefs result and the stated limitation.
Questions about this workflow
What needs to be ready?
Telegram and Ahrefs must be connected to Notis. The trigger needs an explicit usage-check button in a bot message. The bot message must already include the relevant inline button.
What does Ahrefs change?
Nothing. This workflow reads Ahrefs data and reports it through Notis. This reads quota; it cannot raise limits or reserve credits.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link Telegram to Ahrefs. A trigger fires from one place; an action lands in another.
Telegram triggers
Ahrefs actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Backlinks stats retrieval
Retrieves comprehensive backlink statistics for a specified website or url using ahrefs' site explorer tool. this endpoint provides crucial data for seo analysis, including the total number of backlinks, referring domains, and potentially the domain rating (dr). it's essential for understanding a site's link profile, assessing its seo performance, and conducting competitive analysis. the tool is particularly useful when users need detailed insights into a website's backlink structure or when comparing the backlink profiles of multiple domains. note that the data returned is based on ahrefs' extensive web crawl and may not include very recent backlinks.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Batch Url Analysis
Performs a batch analysis on multiple urls or domains using ahrefs' powerful seo metrics. this endpoint allows users to retrieve key seo data for up to 100 targets simultaneously, streamlining the process of analyzing multiple websites or pages. it's particularly useful for comparing competitors, analyzing site sections, or processing large sets of urls efficiently. the endpoint offers customization options for selecting specific metrics, filtering by country, and choosing the calculation mode for volume-based metrics. while it provides comprehensive data, users should be aware of the 100-target limit per request and ensure they have sufficient api quota for large-scale analyses.
New Message Received
Triggered when your bot receives a new message in a private chat, group, or supergroup. To receive every message in a group, Privacy Mode must be disabled for the bot in BotFather.
Domain rating for site explorer
Retrieves the domain rating (dr) for a specified domain. domain rating is an ahrefs metric that measures the strength and authority of a website's backlink profile on a logarithmic scale from 0 to 100. this endpoint should be used when you need to quickly assess the overall seo strength of a domain based on its backlink profile. it's particularly useful for competitive analysis, link building research, and evaluating potential partnership opportunities. the tool provides a single, easy-to-understand metric but does not offer detailed information about the backlinks themselves or other seo factors. for more comprehensive backlink analysis, consider using other ahrefs endpoints that provide more detailed backlink data.
New Channel Post
Triggered when a new post is published to a channel where your bot is an administrator.
Domain rating history
Retrieves the historical domain rating (dr) data for a specified domain over time. this endpoint is part of ahrefs' site explorer tool and provides insights into how a domain's authority has changed. it's useful for tracking the impact of seo efforts, analyzing competitors, or understanding long-term trends in domain strength. the tool returns a time series of domain rating values, allowing users to visualize changes in a domain's perceived authority according to ahrefs' metrics. it should be used when analyzing the historical performance of a domain in terms of its overall seo strength and backlink profile quality. note that this endpoint focuses solely on domain rating and does not provide other metrics like backlink counts or organic traffic data.
Callback Query Received
Triggered when a user taps an inline keyboard button attached to one of your bot's messages.
Explore keywords overview
Retrieves a comprehensive overview of keyword data from ahrefs' keywords explorer tool. this endpoint provides essential insights for seo professionals and content strategists, offering a summary of key metrics such as search volume, keyword difficulty, and potential traffic. it's ideal for users looking to get a quick snapshot of keyword performance and opportunities without diving into specific keyword details. the overview likely includes aggregate data and trends, helping users to make informed decisions about their keyword strategy. while it offers a broad perspective, it may not provide in-depth analysis of individual keywords. use this endpoint when you need a high-level view of your keyword landscape or to identify general trends in your niche.
Message Edited
Triggered when a message in a chat your bot can see is edited by its sender.
Explore keyword volume by country
Retrieves the search volume data for specified keywords across different countries using ahrefs' keywords explorer tool. this endpoint allows users to obtain accurate search volume information, helping in keyword research and content strategy planning for specific geographic regions. it's particularly useful for seo professionals and content marketers looking to optimize their targeting for different markets. the endpoint provides monthly search volume data, which can be used to gauge the popularity and potential traffic of keywords in various countries. note that the data is based on ahrefs' extensive database and may not always exactly match real-time google search volumes.
New Chat Member
Triggered when a new member joins a group or supergroup the bot belongs to, including when the bot itself is added.
Explore linked domains of a site
Retrieves a list of external domains that the specified target website or url links to, using ahrefs' site explorer functionality. this endpoint is crucial for analyzing a website's external linking structure, which can provide insights into its content strategy, partnerships, and overall seo approach. it's particularly useful for competitive analysis, link building strategies, and identifying potential opportunities or risks in a website's outbound link profile. the endpoint returns detailed information about each linked domain, including the number of links pointing to it from the target site.
Explore matching terms for keywords
The keywords explorer matching terms endpoint retrieves a list of keyword phrases that match or contain the specified keyword from ahrefs' vast database. this tool is part of ahrefs' keyword explorer functionality and is designed to assist in comprehensive keyword research for seo purposes. it returns matching terms along with their relevant metrics such as search volume, keyword difficulty, and potential traffic. this endpoint is particularly useful when expanding a seed keyword list, finding long-tail variations, or discovering closely related search terms. the tool takes into account the specified country for localized results, allowing for targeted keyword strategies in different markets. it's important to note that while this tool provides valuable keyword suggestions, it should be used in conjunction with other ahrefs features for a complete seo strategy.
Connect any two apps with Notis in the middle.
Not just Telegram and Ahrefs. Any combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Ahrefs.