ScraperFlyAPI веб-данных для AI

request control

API для скрапинга 429 ограничения по скорости и решения по откату

Ошибка 429 или ограничения обычно является операционным сигналом: рабочий процесс движется слишком быстро, достигается лимит кредита или плана, конкуренция слишком агрессивна, или публичная цель требует более спокойного ритма запросов. ScraperFly помогает командам классифицировать лимит перед тем, как увеличивать нагрузку на тот же профиль запроса.

429 темп работы

Замедлите рабочий процесс намеренно, прежде чем увеличивать нагрузку на тот же запрос

Код 429 не является тем же типом ошибки, что и неверный URL, отсутствующий API-ключ или ошибка 403 на целевом сайте. Обычно это означает, что текущий ритм запросов слишком агрессивен для лимита аккаунта, лимита плана, настройки параллельности, политики повторных попыток или терпимости публичной цели.

ScraperFly помогает командам рассматривать 429 как операционный сигнал. Проверьте оставшиеся кредиты, лимиты плана, параллельность маршрутов, доказательства ответа и окна повторных попыток, затем примените откат или уменьшите нагрузку, прежде чем добавлять более строгие контрольные механизмы запросов.

откатпараллельностьбезопасное масштабирование
Команда рассматривает лимиты скорости API для скрапинга 429 с откатом, параллельностью, кредитами, окном повторных попыток и контролем безопасного масштабирования

Что означает 429 в скрапинге?

Ответ 429 обычно означает, что было отправлено слишком много запросов для текущего контекста. Этот контекст может быть вашим аккаунтом, вашим планом, правилом параллельности, целевым веб-сайтом, классом маршрута или узким окном повторных попыток. Правильное решение зависит от того, какой лимит был превышен.

Вот почему обработка 429 должна начинаться с классификации. Если каждая цель начинает давать сбой одновременно, проверьте состояние аккаунта, кредиты, месячные лимиты и глобальную параллельность. Если одна цель или группа маршрутов возвращает 429, в то время как другие цели остаются здоровыми, проверьте терпимость со стороны цели, ритм повторных попыток, интервал запросов и то, является ли маршрут более тяжелым, чем ожидалось.

Практическое замечание: 429 является сигналом темпа в первую очередь. Уменьшите нагрузку и проверьте лимиты, прежде чем делать каждый запрос более дорогим.

Как отделить лимиты аккаунта от лимитов скорости со стороны цели?

Лимиты со стороны аккаунта обычно проявляются в рабочих процессах или после предсказуемого порога использования. Они указывают на оставшиеся кредиты, месячные лимиты плана, потолки параллельности, неоплаченный статус или операционное правило, предназначенное для поддержания стабильности аккаунта. Лимиты скорости со стороны цели обычно проявляются вокруг конкретного публичного веб-сайта, семейства маршрутов, страны, временного окна или профиля запроса.

Оба случая требуют разных действий. Лимиты аккаунта нуждаются в видимости и планировании. Лимиты со стороны цели нуждаются в темпе, группировке маршрутов, откате и иногда более узком профиле захвата. Рассматривать каждую 429 как проблему прокси может привести к потере кредитов, потому что цели может просто потребоваться меньше параллельных запросов или более длинное окно повторных попыток.

Сигнал 429 Вероятное значение Лучшее следующее действие
429 появляется на многих целяхДавление со стороны аккаунта, плана или глобальной параллельностиПроверьте кредиты, лимиты плана, неоплаченный статус и настройки рабочих процессов.
429 появляется на одной целиПубличный веб-сайт ограничивает текущий ритм запросовУменьшите параллельность и добавьте откат, специфичный для маршрута.
429 появляется после повторных попытокПолитика повторных попыток может усиливать лимитИспользуйте ограниченный экспоненциальный откат и лимиты повторных попыток.
429 появляется только на отрисованных запросахПрофиль запроса может быть слишком тяжелым для объемаКлассифицируйте, какие маршруты действительно нуждаются в отрисовке.
429 появляется по стране или временным окнамТерпимость цели может варьироваться в зависимости от региона или расписанияГруппируйте маршруты и темпируйте запросы в зависимости от контекста цели.

Что должна делать безопасная политика отката?

Безопасная политика отката замедляет повторные попытки, не скрывая основную проблему. Она должна повторять запрос только тогда, когда сбой, вероятно, временный, увеличивать задержку после повторных лимитов, ограничивать общее количество попыток и фиксировать причину каждой повторной попытки. Если цель продолжает возвращать 429 после отката, продолжение повторных попыток обычно менее полезно, чем уменьшение параллельности или изменение стратегии маршрута.

Откат также должен быть ограничен. Лимит одной цели не должен приостанавливать каждый несвязанный рабочий процесс, если только доказательства не указывают на давление по всему аккаунту. Группы маршрутов, домены, страны и профили запросов могут иметь разную терпимость. Производственный скрапер становится более надежным, когда он замедляет правильный поток, а не останавливает или ускоряет всю систему.

Для более широких решений по сбоям сравните страницу ошибок API 403 для скрапинга и руководство по пустым HTML-ответам API для скрапинга. Они охватывают случаи, когда ответ заблокирован, неполный или вводящий в заблуждение, а не просто ограничен по скорости.

Как командам настроить параллельность?

Параллельность должна основываться на доказательствах, а не на амбициях. Начните с консервативного объема запросов, измерьте успешные ответы, задержку, размер ответа и частоту 429, затем увеличивайте только тогда, когда цель остается стабильной. Маршрут, который требует отрисовки браузера, визуальных файлов, премиум-маршрутизации или непрерывности сессии, обычно должен масштабироваться более осторожно, чем простой HTML-маршрут.

Вес запроса имеет значение, потому что более тяжелые профили потребляют больше ресурсов и могут увеличить давление с обеих сторон рабочего процесса. Простой HTML-запрос не равен отрисованной сессии браузера с ожиданиями, скриншотами и более сильной маршрутизацией. Самая безопасная стратегия — сначала классифицировать шаблоны маршрутов, а затем назначить параллельность в зависимости от цели и профиля.

Контроль Используйте его, когда Поведение, безопасное для 429
ОткатЛимит может быть временным или основанным на окнеУвеличьте задержку, ограничьте попытки и остановите шумные циклы повторных попыток.
Лимиты параллельностиСлишком много рабочих процессов одновременно обращаются к одной целиОграничьте по домену, группе маршрутов и профилю запроса.
Проверки аккаунтаЛимиты появляются в рабочих процессахПроверьте кредиты, месячный лимит, неоплаченный статус и соответствие плану.
Классификация маршрутовНекоторые страницы тяжелее другихДержите простые страницы легкими и изолируйте отрисованные или визуальные задачи.
Контроль запросовПоведение цели зависит от контекстаДобавьте заголовки, сессии, маршрутизацию по странам или отрисовку только тогда, когда доказательства это поддерживают.

Когда 429 должен изменить профиль запроса?

429 должен изменить профиль запроса только после проверки темпа. Иногда ответ заключается просто в меньшей параллельности. Иногда маршруту требуется другой рабочий процесс: исходный HTML вместо отрисованного вывода, текст или Markdown вместо скриншота и PDF, меньше ожиданий, более узкий выбор целей или лучшая группировка по домену и семейству маршрутов.

Есть случаи, когда контроль запросов имеет значение. Заголовки могут помочь, когда публичная цель ожидает законного контекста. Сессии могут помочь, когда поведение скорости зависит от непрерывности. Маршрутизация по странам может помочь, когда лимиты различаются по географии. Премиум-маршрутизация может помочь, когда качество маршрута доставки является ограничивающим фактором. Но это целенаправленные решения, а не стандартные исправления для каждой 429.

Используйте API Builder, чтобы протестировать меньший профиль перед масштабированием. Сравните исходный HTML, отрисованный вывод, форматы ответов, конечный URL, статус, размер ответа и задержку. Страница форматов ответов API для веб-скрапинга может помочь выбрать самый легкий вывод, который может использовать ваш последующий рабочий процесс.

Как кредиты и выставление счетов вписываются в восстановление после 429?

Кредиты и выставление счетов не заменяют темп, но они влияют на операционные решения. Если проект все еще изучает терпимость цели, кредиты по принципу "плати по мере использования" сохраняют гибкость пути покупки. Если повторяющийся объем предсказуем и профили маршрутов проверены, месячные кредиты могут упростить планирование. В любом случае, давление запросов все еще должно соответствовать лимитам аккаунта и терпимости цели.

Модель ценообразования ScraperFly полезна, потому что она позволяет командам начинать с малого, тестировать цель и масштабироваться после того, как рабочая нагрузка станет лучше понятной. Команда может сохранять неравномерные эксперименты на гибких кредитах, переводить повторяющиеся задачи на месячные планы и избегать превращения краткосрочного теста в крупную фиксированную подписку. Ознакомьтесь с ценами и калькулятором стоимости кредитов API для веб-скрапинга при оценке того, как вес и объем запросов взаимодействуют.

Как ScraperFly делает обработку 429 практичной?

ScraperFly предоставляет командам один уровень API для форматов запросов, отрисовки, маршрутизации, сессий, заголовков, визуального вывода и диагностики. Это упрощает обработку лимитов скорости, потому что доказательства ответа, контроль запросов и модель затрат остаются в одном рабочем процессе. Вы можете увидеть, является ли проблема давлением со стороны аккаунта, давлением со стороны цели, весом маршрута или поведением повторных попыток.

Цель не в том, чтобы давить сильнее по умолчанию. Цель — принять более чистое решение о масштабировании: начать с самого легкого полезного запроса, замедлиться, когда цель просит о пространстве, зарезервировать более тяжелые профили для маршрутов, которые доказывают, что они в них нуждаются, и увеличивать объем, как только ритм повторных попыток станет стабильным.

Практическое замечание: хорошая обработка 429 превращает неудавшийся объем в лучший темп, более четкие лимиты и профиль запроса, который может масштабироваться без постоянной борьбы с целью.

Проверка лимита 429

Узнайте, исходит ли лимит от давления со стороны аккаунта, параллельности, повторных попыток или терпимости цели

Ответ 429 является полезным доказательством, когда команды проверяют, где появляется лимит: по всему аккаунту, на одной цели, после циклов повторных попыток, на тяжелых отрисованных маршрутах или в пределах конкретного временного окна. ScraperFly помогает превратить эти доказательства в более спокойный план запросов.

Сырой HTML-ответ, сопоставленный с видимыми данными страницы
01

Доступность сырого HTML

Проверьте, присутствуют ли необходимые вам поля уже в первом HTML-ответе.

Лучший первый тест для простых страниц, статей, документов, списков и деталей продуктов.

Сравнение до и после рендеринга JavaScript
02

Зависимость от JavaScript

Сравните сырой HTML с отрендеренным DOM или скриншотом перед включением рендеринга браузера.

Используйте рендеринг, когда сырой HTML является лишь оболочкой, а скрипты создают полезный контент.

Cookies, согласие, контекст сессии и доступа для скрапинга
03

Состояние и контекст доступа

Определите, влияют ли cookies, согласие, границы входа, пагинация или состояние одного и того же посетителя на ответ.

Используйте сессии и заголовки, когда непрерывность изменяет данные, которые вы получаете.

Региональные вариации контента по странам и маршрутам
04

Гео/вариация контента

Проверьте, изменяет ли страна, язык, валюта, запасы, SERP, реклама или репутация маршрута результат.

Используйте гео- или премиум-маршрутизацию только тогда, когда цель подтверждает, что ответ варьируется в зависимости от маршрута.

Проверки, которые делают обработку лимитов скорости практичной

Где находится целевое поле?

Узнайте, существует ли поле в сыром HTML, отрендеренном DOM, вызове API, структурированных данных, файле или состоянии взаимодействия позже.

Что изменяет ответ?

Выберите несколько URL-адресов и сравните статус, конечный URL, длину контента, перенаправления, пустые состояния и различия в видимых результатах.

Какой контекст необходим?

Отметьте любую зависимость от согласия, локали, файлов cookie, заголовков, границ аутентификации, пагинации, фильтров или предыдущих запросов.

Как выглядит неудача?

Определите сигналы для заблокированных, частичных, устаревших, перенаправленных, пустых, истекших или несоответствующих регионам ответов перед масштабированием.

Классифицируйте давление перед увеличением объема

Режим получения

Доступность сырого HTML определяет, может ли первый запрос оставаться простым или требует рендеринга, ожиданий, скриншотов или извлечения.

Контекст запроса

Требования состояния определяют, нужно ли добавлять заголовки, файлы cookie, сессии, обработку согласия или стабильный профиль посетителя.

Выбор маршрута

Гео и репутационные данные определяют, достаточно ли стандартного маршрута или оправдан ли маршрут по стране/премиум.

Правила валидации

Известные состояния неудачи становятся проверками для повторных попыток, эскалации, проверки качества и решения о том, когда более легкий профиль все еще полный.

Экономика лимитов скорости

Контролируйте расходы, сопоставляя давление запросов с проверенной терпимостью цели

Восстановление после лимита скорости не должно делать каждую задачу более тяжелой. ScraperFly помогает командам сохранять маршруты исходного HTML легкими, изолировать отрисованные или визуальные задачи и использовать кредиты вокруг рабочих нагрузок, которые были протестированы, вместо того чтобы гадать объем в первый день.

Легкий HTML-запрос, возвращающий простой ответ
01

Базовый запрос

Используйте базовый запрос, когда публичный HTML уже содержит необходимые вам поля.

Самый легкий профиль запроса; сохраняйте его, когда ответ завершен.

Рендеринг JavaScript, создающий полный DOM
02

Рендеринг

Используйте рендеринг, когда сырой HTML является оболочкой, а JavaScript завершает страницу.

Более тяжелый профиль; используйте его только когда вывод браузера изменяет результат.

Несколько запросов с сохранением cookies и состояния посетителя
03

Состояние сессии

Используйте сессии, когда cookies, согласие, локализация или пагинация изменяют ответ.

Более тяжелый профиль состояния; сохраняйте его только когда важна непрерывность.

Маршрутизация запросов через гео и более качественные маршруты
04

Премиум маршрутизация и гео

Используйте премиум маршрутизацию или гео только когда источник, страна, репутация или региональный контент изменяют результат.

Самый тяжелый профиль маршрутизации; применяйте его только к целям, которые доказывают, что они в этом нуждаются.

Что увеличивает давление запросов

Больше инфраструктурной работы

Рендеринг в браузере, выбор маршрутов и более длительное ожидание означают, что платформе нужно делать больше, чем просто возвращать простой ответ.

Больше неопределенности цели

Перенаправления, пустые состояния, ограничения по скорости и страницы с вызовами часто требуют более сильных вариантов доставки или повторных попыток.

Больше состояния для сохранения

Cookies, сессии, согласие и многостраничные потоки добавляют движущиеся части, которых нет у простого безстатусного запроса.

Больше доказательств для возврата

Скриншоты, PDF-файлы, отрендеренный вывод и более богатые артефакты ответа полезны, но они тяжелее, чем простой HTML.

Как сохранить объем предсказуемым

Протестируйте перед масштабированием

Сначала протестируйте небольшой набор URL и группируйте цели по самому легкому профилю, который возвращает полные данные.

Не рендерить по умолчанию

Проверьте сырой HTML перед включением рендеринга. Многие публичные страницы уже содержат необходимые вам данные.

Эскалируйте по фактам

Переходите на более высокий уровень только когда ответ показывает отсутствие контента, зависимость состояния, гео-вариации или проблемы с маршрутизацией.

Измеряйте полезные результаты

Оптимизируйте на основе действительных записей, а не объема сырых запросов. Более легкий профиль лучше всего, только когда он остается полным.

Создатель восстановления 429

Создайте поведение повторной попытки и отката на основе ответа, который вы действительно получили

Используйте API Builder, чтобы сравнить профили запросов, форматы ответов и поведение цели перед увеличением объема. Хороший путь восстановления после 429 корректирует темп, параллельность, окна повторных попыток и вес запроса на основе доказательств.

01
01

Замедлите давление запросов перед добавлением более строгих контролей

Уменьшите параллельность, добавьте откат и ограничьте повторные попытки, когда маршрут начинает возвращать 429.

02
02

Отделите лимиты аккаунта от толерантности цели

Проверьте кредиты, лимиты плана, конкуренцию и то, появляется ли 429 глобально или только на одной цели.

03
03

Используйте более тяжелые профили только для маршрутов, которые доказывают, что они в них нуждаются

Сохраняйте простые страницы на легком захвате и изолируйте рендеринг, визуальный вывод или изменения маршрутизации для более сложных классов маршрутов.

Управление обработкой 429

url

Публичный URL или группа маршрутов, возвращающая ответы 429.

render

Используйте выполнение в браузере только тогда, когда это изменяет полезный публичный контент.

format

Выберите самый легкий вывод, который может использовать ваш последующий рабочий процесс.

session

Используйте непрерывность только тогда, когда связанные публичные запросы зависят от общего состояния.

country

Тестируйте региональную толерантность только тогда, когда доказательства цели варьируются в зависимости от местоположения.

premium

Используйте более сильную маршрутизацию для доказанных сложных маршрутов, а не как первый ответ на проблемы с темпом.

пример cURL

Генерируйте Markdown с той же формой запроса, которую вы можете использовать в производстве

curl "https://scraperfly.com/api/v1?url=https%3A%2F%2Fexample.com&format=markdown" \
  -H "apikey: YOUR_API_KEY"

Гибкое масштабирование

Начните с малого, узнайте лимит цели, затем выберите путь кредита, который подходит

ScraperFly позволяет командам тестировать цели с помощью бесплатных и оплачиваемых кредитов перед тем, как перейти к регулярному ежемесячному объему. Как только профиль маршрута, параллелизм и ритм повторных попыток будут проверены, ежемесячные кредиты облегчают планирование предсказуемых рабочих нагрузок.

Бесплатно

Free

Попробуйте ScraperFly с достаточным количеством кредитов для выполнения реальных тестовых запросов.

$01000 кредитов включено

  • Карта не требуется
  • Доступ к API для тестирования
  • Обновляйтесь только тогда, когда вам нужно больше объема
Бесплатная регистрация
Без подписки

Pay as you go

Купите кредиты один раз и тратьте их, когда вашему проекту это нужно.

Пакеты кредитовБез ежемесячных обязательств

  • Кредиты остаются доступными до использования
  • Лучше всего для нерегулярных нагрузок
  • Автоматически переключитесь сюда, если платеж по подписке не прошел
Бесплатная регистрация
Ежемесячный

Solo

Компактный ежемесячный план для небольших регулярных задач по сбору данных.

$9.9910,000 кредитов каждый месяц

  • Неиспользованные кредиты переносятся
  • Хорошо подходит для запланированных задач и небольших мониторингов
  • Отмените или измените план в клиентском портале
Бесплатная регистрация
Ежемесячный

Team

Более высокий объем кредитов в месяц для мониторинга и производственных потоков.

$49.99100,000 кредитов каждый месяц

  • Неиспользованные кредиты переносятся
  • Создан для частых производственных нагрузок
  • Используйте ту же панель управления, журналы и элементы управления клиентским порталом
Бесплатная регистрация

Нужен больший объем или индивидуальные лимиты? Свяжитесь с поддержкой, и мы разработаем план в соответствии с вашими целями, рендерингом и потребностями маршрутизации.

Вопросы 429

Общие вопросы о лимитах скорости API 429

Быстрые ответы для команд, оценивающих поведение веб-скрапинга API: форматы запросов, рендеринг JavaScript, маршрутизация прокси, кредиты, файлы, безопасность и выставление счетов.

Быстрые ответы

Что говорит вам 429

Читать лимиты скорости как сигналы давления.

Является ли 429 всегда блокировкой цели?

Нет. Это может быть связано с лимитами аккаунта, лимитами плана, параллелизмом, повторными попытками или ограничением скорости со стороны цели.

Должен ли я повторять попытку немедленно?

Нет. Немедленные повторные попытки могут усугубить проблему. Используйте задержку, ограничения повторных попыток и темп на уровне маршрута.

Задержка и параллелизм

Замедлите правильный рабочий поток.

Как должен работать backoff?

Увеличьте задержку после повторных лимитов, ограничьте попытки и остановите циклы повторных попыток, которые продолжают попадать в одно и то же окно.

Как следует настраивать параллелизм?

Начните с осторожности, группируйте по целям и типам маршрутов, затем увеличивайте только при стабильности уровня успеха и задержки.

Когда менять профиль?

Добавьте более строгие меры контроля с доказательствами.

Исправляет ли рендеринг 429?

Рендеринг исправляет отсутствующий контент, созданный браузером, а не давление запросов. Используйте его только тогда, когда это улучшает ответ.

Исправляет ли премиум маршрутизация 429?

Иногда, но только когда качество маршрута является ограничивающим фактором. Сначала протестируйте темп.

Кредиты и масштабирование

Соответствуйте пути покупки проверенному объему.

Удаляют ли кредиты ограничения по целям?

Нет. Кредиты финансируют использование, но параллелизм и допустимость целей все еще должны соблюдаться.

Когда мне следует выбрать ежемесячные кредиты?

Выбирайте ежемесячные кредиты после того, как объем и профили маршрутов станут предсказуемыми.