API Rules - Ahrefs API

Ahrefs API v2 will stop working on March 1st, 2024

This documentation is for the legacy version of our API (v2), which has been discontinued. All active API v2 subscriptions will stop working on March 1st, 2024. Existing Integration apps will continue to work as before until further notice, but new submissions are no longer accepted.

To switch from API v2 to v3, please contact our Enterprise team. Read about API v3.

API Guide

Customers with access to Ahrefs API via API subscription or Integrations must comply to the Ahrefs Terms and Conditions. Please carefully review the stipulations below before using our API services:

  • 1. You are not allowed to white-label our data without our approval.
  • 2. If you show our data to third party, you are asked to follow attribution requirements. It may be done in different ways. If you are not sure, contact us. Ahrefs reserves the right to decide which kind of attribution is sufficient in your case and therefore it may vary from case to case.
  • 3. You can not change names of our metrics, namely URL Rating and Domain Rating.
  • 4. Access to API and/or Integrations API may be suspended or terminated anytime and for any reason.
  • 5. If your access to Ahrefs API and/or Integrations API is cancelled due to breach of our terms, you are not entitled to get a refund of any kind.
  • 6. Ahrefs reserves the right to discontinue providing service anytime and for any reason.

Do note that we will continue to update this page as more API specifications and functionalities will be added.