Довідник
Звіт Ahrefs про беклінки проти виводу API: довідник дій
Якщо ви звикли експортувати звіт Ahrefs про беклінки, цей довідник показує, які частини ви можете відтворити за допомогою наших дій, скільки коштує кожен запит і де великі платформи залишаються попереду.
Дії, ціни та їх заміни у звіті
| Дія | Кредити | Найближча частина типового звіту | Примітки |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | Кількість заголовків | Ключ не потрібен |
| bulk_dr | 1 | Колонка DR для списку | До 2000 доменів за запит |
| compare | 1 | Порівняння доменів поруч | До 20 доменів |
| top, dr_distribution, tld_breakdown | 1 | Зведені діаграми | Зведення у вигляді розподілу |
| refdomains | 2 | Вкладка посилальних доменів | Пагінація |
| backlinks | 2 | Вкладка беклінків | Пагінація |
| anchors, anchor_cloud | 2 | Вкладка якірних текстів | Хмара призначена для відображення |
| toppages | 2 | Найкращі за кількістю посилань | Сторінки, які приваблюють посилання |
| intersect | 2 | Перетин посилань | 2–10 доменів |
| search, keyword | 3 | Прямого відповідника немає | Пошук за якірним текстом, заголовком та URL |
Як вкладки звіту відображаються на наших діях
Більшість експортів звітів мають вкладками, і кожна вкладка має приблизний відповідник тут. Це не точна копія. Сприймайте це відображення як точку відліку, оскільки поле, яке є в одній вкладці, може повністю відсутнє у нашій відповіді.
Вкладка посилальних доменів
Уявіть звіт, який відкривається з посилальними доменами, відсортованими за DR. Наш найближчий аналог — refdomains за 2 кредити, і його можна відсортувати так само. Очікуйте, що доведеться перейменувати одну-дві колонки у вашому скрипті, оскільки назви полів у рядку залежать від дії.
Виправте сортування між місяцями. Список, відсортований за DR одного місяця та за трафіком іншого, не можна чесно порівняти, тому вкажіть ключ сортування в назві файлу.
Вкладка якірних текстів і чому хмара призначена для відображення
anchors — це запит для вкладки якірних текстів за 2 кредити. anchor_cloud коштує стільки ж, але, як зазначено в таблиці вище, він призначений для відображення. Якщо рішення залежить від цифр, читайте звичайний список.
Аналізуйте якірні тексти з одним питанням: чи написав би ці слова реальний автор? Назви брендів та прості URL зазвичай проходять. Блок однакових фраз-грошей, повторюваних на багатьох доменах, — ні, і саме цей блок варто перевірити в першу чергу.
Топові сторінки та перегляд від 2 до 10 доменів
toppages — найближчий аналог вкладки «найкращі за посиланнями». Він показує, які сторінки приваблюють посилання, і це часто говорить більше, ніж загальна кількість домену, коли зміна в рейтингу торкається однієї папки сайту.
intersect приймає від двох до десяти доменів і коштує 2 кредити за запит. Скажімо, ви порівнюєте свій сайт із двома конкурентами. Перетин покаже, які сайти-посилальники спільні для всіх трьох, що просто і дешево.
Параметри, що застосовуються до всіх запитів
Три речі керують кожним списком. Це page, per та пара sort з order. Фіксуйте їх між місяцями.
per приймає значення від 10 до 5000, хоча один запит повертає до 1000 рядків, а глибока пагінація зупиняється на 50000 рядках. Кожен запит нараховується один раз незалежно від кількості рядків, тому запит повної сторінки коштує стільки ж, скільки запит десяти рядків.
Аутентифікація вимагає або key=sk_... у запиті, або заголовка Authorization: Bearer sk_.... CORS відкритий, але зберігайте ключ на сервері, оскільки код у браузері буде доступний кожному відвідувачу.
Порядок має значення. При проходженні по результатах сортируйте за спаданням DR для доменів, які, ймовірно, мають значення, або за зростанням, щоб перевірити довгий хвіст малих сайтів. Який би ви вибір не зробили, запишіть його поруч із файлом.
Сприймайте таблицю вище як карту, а збережені відповіді — як місцевість. Якщо очікуване поле відсутнє, будуйте логіку навколо того, що є.
Щомісячний експорт за п’ятьма кроками
Виконуйте ті самі п’ять кроків щомісяця, щоб збережені файли коректно співпадали при порівнянні.
- 1
Оберіть запити
Оберіть
refdomains,anchorsтаtoppagesдля кожного домену. Overview та stats безкоштовні, тому додайте їх до тієї ж папки. - 2
Фіксуйте глибину
Встановіть
page,per,sortтаorderодин раз і зберігайте їх. Per може сягати 5000, але один запит повертає до 1000 рядків. - 3
Зберігайте кожну відповідь без змін
Записуйте необроблений JSON на диск перед будь-яким парсингом. Якщо скрипт згодом дасть збій, збережена копія стане основою для повторного запуску.
- 4
Прочитайте об'єкт _credits
Кожна аутентифікована відповідь повідомляє про вартість та залишок коштів. Скопіюйте обидва значення в рядок журналу, щоб витрати за місяць були видимими без використання панелі керування.
- 5
Порівняйте з минулим місяцем
Зробіть diff збережених копій. Рецепт diff описує три стовпці, які варто зберегти.
Кредити, ліміти рядків та рахунок за місяць
Прайс-лист короткий. Сума рахунку залежить від частоти викликів та пагінації. Три звички визначають більшу частину витрат.
Одне списання за виклик, незалежно від кількості рядків
Кожен виклик нараховується один раз, тому per=1000 коштує стільки ж, скільки per=10 для тієї ж дії. Повна сторінка є вигідним варіантом для списків, які ви будете використовувати повторно, і неефективним для швидкого перегляду.
Уявіть, що ви витягуєте refdomains для одного домену щонайменше раз на місяць. Це 2 кредити, або $0.0002 на місяць за опублікованою ставкою $0.0001 за кредит.
Стеля в 50 000 рядків
Глибока пагінація зупиняється на 50 000 рядках. Цикл, який продовжує запитувати наступну сторінку після цього, не отримає нових даних, тому обмежте кількість сторінок перед початком циклу.
Досягнення стелі при 1 000 рядків за виклик вимагає п'ятдесяти викликів. При 2 кредитах за виклик це 100 кредитів, або $0.01. Дешево, але лише якщо скрипт зупиняється, коли має.
Маленький бюджет для щомісячної звички
Уявіть десять доменів, для яких refdomains та anchors витягуються раз на місяць. Це 40 кредитів на місяць, або $0.004, які списуються з безкоштовних $100 (1 000 000 кредитів) після реєстрації.
За такого темпу безкоштовних кредитів вистачить на довгий час, а журнал витрат покаже, чи тримається темп. Тримайте його.
Усунення несправностей у відповідях
| Ви бачите | Причина | Виправлення |
|---|---|---|
| HTTP 401 | Ключ відсутній або неправильний | Перевірте ключ та правильність написання заголовка |
| HTTP 402 | Кредити закінчилися | Поповніть баланс через USDT (TRC-20) на сторінці облікового запису |
| ok є false | Запит відхилено | Прочитайте повідомлення в тілі запиту та параметри, які ви надіслали |
| Менше рядків, ніж показує великий пакет | Різний час індексації та краулінгу | Порівнюйте тренди, а не загальні суми |
| Посилання, яке ви створили минулого тижня, відсутнє | Індекс перезбирається приблизно раз на місяць | Перевірте знову наступного циклу |
Відсутній рядок — це питання, а не відповідь
Рядок, який зникає між двома відповідями, є поширеною несподіванкою. Перш ніж визначити його значення, розділіть історії, які він може розповідати.
Три історії за одним відсутнім рядком
Посилання могло ніколи не проіндексуватися або було видалено. Третя історія — це таймінг: сторінку прокраулили до або після перезбірки індексу, і рядок з'явиться в пізнішому циклі.
Один виклик не може розділити ці сценарії. Лише друга копія, отримана пізніше, плюс огляд самої сторінки звузять список варіантів.
Оцініть рядок, перш ніж переслідувати його
Перевірте DR домену та сторінку-джерело перед будь-яким зверненням. Втрачене посилання з слабкого сайту рідко змінює план. Втрачене посилання зі сторінки, яка залучала читачів, може вимагати нотатки власнику. Таблиця підозрілих показує, де знаходиться відсутній рядок серед ширших причин.
Перенесення експорту на наші виклики
Чи можу я експортувати ті ж стовпці, що й Ahrefs?
Не один до одного. Поля рядків варіюються залежно від дії, тому відкрийте збережену відповідь і самостійно зіставте назви полів. Таблиця вище вказує найближчу дію для кожної частини звіту, але назви полів будуть іншими.
Чи дешевший API, ніж підписка Ahrefs?
Відповідь залежить від обсягу викликів. Наша опублікована ціна становить $0.10 за 1 000 однокредитних викликів. Ahrefs продає API-одиниці всередині підписок, від $129 на місяць за 200 000 одиниць, з мінімумом 50 одиниць за запит. Порахуйте свої виклики перед прийняттям рішення.
Чи будуть старі експорти порівнюватися з новими?
Тільки якщо сортування, глибина та джерело збігаються. Файл, витягнутий з іншого інструменту в інший тиждень, є іншою вибіркою. Зберігайте старі файли та починайте нову серію з чітко позначеною парою.
Чи потрібно зберігати ключ на моєму сервері?
Так. CORS відкритий, тому браузер може викликати API, але ключ у фронтенд-коді буде видимий для кожного відвідувача. Надсилайте запити з вашого сервера та зчитуйте ключ із змінної середовища.
Перш ніж будувати звіт на основі цих викликів
- Відкрийте одну збережену відповідь для кожної дії та запишіть назви полів рядків, які ви фактично отримуєте.
- Визначте, який місячний лейбл увійде в назву кожного файлу.
- Зберігайте
page,per,sortтаorderоднаковими між щомісячними витягами. - Логуйте об'єкт
_creditsз кожної аутентифікованої відповіді, щоб витрати на кожне завдання були видимими. - Обмежте глибоку пагінацію в своєму скрипті, оскільки списки зупиняються на 50 000 рядках.
- Додайте примітку про свіжість до будь-якого звіту, який ви передаєте, вказавши, що індекс оновлюється приблизно раз на місяць.
Читання обгортки
Кожна відповідь містить ok. Аутентифіковані також додають _credits, що дозволяє логувати витрати на кожне завдання та відстежувати баланс.
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"Ahrefs продає API-одиниці всередині підписок, від $129 на місяць за 200 000 одиниць із мінімумом 50 одиниць за запит. Вони також пропонують ключові слова, відстеження позицій та більш свіжий краулінг, так само як і Semrush. Ми покриваємо дані посилань за низькою ціною за виклик і нічим більше. Використовуйте щомісячний робочий зошит, якщо це прогалина, яку потрібно заповнити. Дерево рішень щодо спайму спаму — це гарний перший випадок використання дешевих зведених викликів.
