این endpointها چه چیزی برمی‌گردانند
هر دو گزارش به یک نوع پرسش پاسخ می‌دهند: یک دامنه چقدر قوی است و چه مقدار ترافیک جست‌وجوی ارگانیک کسب میکند؟ دامنهٔ هدف و یک تاریخ snapshot را می‌فرستید و پاسخ، دامنه را در همان تاریخ توصیف میکند.
| Domain Rating | امتیاز اعتبار بک‌لینک Ahrefs برای دامنه، همراه با رتبهٔ جهانی Ahrefs Rank آن. |
|---|---|
| Site Metrics | تعداد کلمات کلیدی ارگانیک و پولی، تعداد کلمات کلیدی ارگانیکی که در سه جایگاه اول رتبه گرفته‌اند، ترافیک ارگانیک ماهانهٔ برآوردی و ارزش برآوردی آن ترافیک. |
هر درخواست دو پارامتر کوئری می‌گیرد: target یعنی دامنه، و date با قالب YYYY-MM-DD. تاریخ صریح است — خودتان انتخاب می‌کنید کدام snapshot خوانده شود، نه اینکه هر چیزی که همین حالا موجود است برگردد.
این در مقایسه با API خود Ahrefs
Ahrefs API خودش را در api.ahrefs.com اجرا میکند (نسخهٔ سوم). این API بسیار فراتر از این صفحه را پوشش میدهد: گزارشهای Site Explorer برای بکلینکها و ترافیک ارگانیک، Keywords Explorer، SERP Overview، Rank Tracker، Site Audit، Brand Radar، Batch Analysis و مدیریت پروژه. احراز هویت با توکن bearer انجام می‌شود که مالک یا مدیر workspace در تنظیمات حساب Ahrefs می‌سازد.
Felo تنها برش باریکی از این سطح را ارائه میدهد: همان دو گزارش Site Explorer که بالا آمد. بقیهٔ API Ahrefs امروز از طریق Felo در دسترس نیست و فهرست این صفحه همان مجموعهٔ کامل است.
نام فیلدها از Ahrefs پیروی میکند، بنابراین گزارشی که می‌شناسید اینجا هم با همان نام خوانده می‌شود.
دسترسی و صورت‌حساب چگونه کار میکند
در سمت Ahrefs، دسترسی به API با پلن پولی ارائه می‌شود و با واحدهای API سنجیده می‌شود. هر درخواستِ قابل صورت‌حساب یک هزینهٔ حداقلی دارد و هزینهٔ واقعی با تعداد ردیف‌های برگشتی و فیلدهایی که انتخاب می‌کنید افزایش می‌یابد؛ پس محدود کردن select و limit مستقیم‌ترین راه برای پایین نگه داشتن مصرف است. درخواست‌ها همچنین در هر دقیقه محدود به نرخ مشخصی هستند؛ عبور از سقف، HTTP 429 برمی‌گرداند.
از طریق Felo به پلن Ahrefs یا کلید API Ahrefs نیاز ندارید. با کلید Felo احراز هویت می‌کنید و این دو گزارش مثل هر endpoint دیگر این پلتفرم از حساب Felo شما صورت‌حساب میشوند.
انتخاب تاریخ snapshot
هر دو endpoint به date نیاز دارند، چون دامنه را در یک روز مشخص توصیف میکنند، نه در یک اسکن زنده. همان تاریخ را برای هر دو بفرستید تا امتیاز اعتبار و داده‌های ترافیک یک لحظه را توصیف کنند. این تاریخ همچنین تعیین میکند کدام دوره خوانده می‌شود: همان پارامترها، اگر دوباره خوانده شوند، هنوز همان دوره را توصیف میکنند.
پرسش‌های متداول
- آیا Felo کل API Ahrefs را ارائه میدهد؟
- نه. امروز دو گزارش Site Explorer در دسترس است: Domain Rating و Site Metrics. بقیهٔ API Ahrefs — بکلینکها، کلمات کلیدی، ردیابی رتبه، ممیزی سایت و گزارشهای دیگر — هنوز از طریق Felo ارائه نمیشود.
- آیا به اشتراک Ahrefs یا کلید API Ahrefs نیاز دارم؟
- نه. endpointهای این صفحه با کلید Felo API خوانده میشوند. نه به پلن Ahrefs نیاز دارید و نه کلید Ahrefs میسازید.
- چرا پارامتر تاریخ الزامی است؟
- هر دو گزارش یک دامنه را در یک روز مشخص توصیف میکنند، نه دادهٔ زنده. تاریخ تعیین میکند اعداد از کدام دوره میآیند، بهجای اینکه سرور بهطور پیشفرض امروز را انتخاب کند.