Before you start
- Who can connect it: an Admin or a Managing Editor. A custom role can connect it when it includes the permission to create, configure and remove organization integration connections. See Roles and permissions.
- Who sees the data: every role that can see Metrics: Editors, Managing Editors and Admins. Keyword research in the editor also needs edit access to the article.
- What you need: an Ahrefs plan that includes API access, which means Lite or higher, and an Ahrefs workspace owner or admin to create the key. An organization has one Ahrefs connection.
Connect
1
Create a key in Ahrefs
In Ahrefs, open Account settings → API keys and create a key. Give it a monthly unit limit: Weelkit treats the smaller of your workspace allowance and the key’s limit as your monthly allowance. Copy the key.
2
Start the connection
Open Organization settings → Integrations (Managing Editors open Integration). In the SEO section, find Ahrefs and choose Connect.
3
Paste the key
Paste the key into Ahrefs API key and choose Connect. Weelkit checks the key and your plan with a free request that spends no units. A message says Ahrefs connection saved.
4
Check the card
The Ahrefs card shows your plan (for a moment it says “Checking your Ahrefs plan…”), the last four characters of the key (for example •••• 4f2a), and Weelkit used 0 of N units this month. Open the card’s ⋯ menu and choose Test connection to check it again. It says Connected to Ahrefs with your plan name.
What Weelkit asks Ahrefs for
Weelkit sends Ahrefs your key, your site’s domain, the public addresses of your published articles, and the keyword when you research one. Your site is the site in your Search Console property, or else the site where your published articles live. If Weelkit can’t find it yet, the panels say so.Where you see it
The Links page appears under Analytics, and Benchmarks under AEO & GEO, only while a vendor connection can answer. If you connect both Ahrefs and Semrush, these panels show Ahrefs.
Units and limits
Ahrefs gives your plan a monthly allowance of API units. Weelkit works inside it:- Weelkit uses at most a quarter. Each calendar month, Weelkit spends at most 25% of your monthly allowance, scheduled pulls and research together. The card shows Weelkit used X of Y units this month, where Y is that quarter.
- Research has its own cap. Keyword research you run, from the editor or by asking the AI, can use at most 10% of your monthly allowance in a month.
- Scheduled pulls pause at 80%. When your Ahrefs account has used 80% of its allowance, counting everything charged to it, Weelkit stops its scheduled pulls until next month.
- Nothing is sent over a cap. A request that would cross a cap isn’t made. The panel says so, and the caps reset each month.
- Opening a page never spends units. Pages show data Weelkit already pulled. Weelkit pulls on a schedule, daily for keyword positions and weekly for the rest, and only while someone has opened a page that shows this data in the last 14 days. If nobody looks, nothing is spent.
- Nothing is retried. Weelkit sends each paid request once. If Ahrefs doesn’t answer in time, units may have been spent, and Weelkit doesn’t send it again.
Replace the key or disconnect
- Replace the key. If Ahrefs stops accepting the key, choose Paste a new key on the card, paste a new one and choose Connect. The connection stays, and Weelkit deletes the data pulled with the old key.
- Disconnect. On the card, open the ⋯ menu, choose Disconnect, then choose Disconnect to confirm. Keep connection cancels. Weelkit deletes the stored key and everything it pulled from Ahrefs, and stops pulling. The panels disappear from your pages.
- Delete the key in Ahrefs if you no longer want it to exist. Disconnecting in Weelkit doesn’t delete it there.