Избор на правилния endpoint

FourA предлага три API endpoints, всеки от които е оптимизиран за различни сценарии. Изборът на правилния спестява време, намалява разходите и подобрява процента на успешни заявки.

Ръководство за бързо вземане на решение

Използвайте single endpoint, когато:

• Целевата страница се рендира на сървъра (не се изисква JavaScript)
• Нуждаете се от максимална скорост (обикновено под 1 секунда)
• Събирате данни от API или статични HTML страници

Използвайте browser endpoint, когато:

• Страницата разчита на JavaScript за рендиране на съдържанието
• Съдържанието се зарежда динамично след първоначалното зареждане на страницата
• Нуждаете се от напълно рендирания DOM

Използвайте proxy endpoint, когато:

• Целевият сайт активно блокира заявки
• Трябва да ротирате множество IP адреси
• Предишни опити са върнали 403 или CAPTCHA страници

Сравнение на endpoints

Single (POST /api/single/)

Най-бързата опция. Изпраща HTTP request с реалистични характеристики, наподобяващи браузър, без да стартира браузърен процес.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products", "unblocker": true}'

Типично време за реакция: от 200ms до 2s Най-подходящ за: API, новинарски сайтове, блогове, статични продуктови страници

Browser (POST /api/browser/)

Отваря вашия URL в Chrome браузърен инстанс. Страницата се зарежда напълно, JavaScript се изпълнява и получавате крайния рендиран HTML.

curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

Типично време за реакция: от 2s до 10s Най-подходящ за: Single-page приложения (SPA), сайтове с мързеливо зареждане (lazy loading), съдържание, рендирано с JavaScript

Proxy (POST /api/proxy/)

Комбинира HTTP requests с автоматична ротация на proxy. Ако първият опит е неуспешен или бъде блокиран, FourA опитва отново през различни proxies.

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing",
      "unblocker": true
    }
  }'

Типично време за реакция: от 1s до 5s Най-подходящ за: Мониторинг на цени в електронната търговия, туристически агрегатори, сайтове със защита срещу ботове

Кога да комбинирате подходите

Някои работни процеси се възползват от използването на няколко endpoints:

1. Започнете със single: тествайте дали страницата връща полезни данни без браузър.
2. Преминете към browser: ако отговорът е празен или липсва съдържание, превключете към рендиране с браузър.
3. Добавете proxy: ако бивате блокирани (403/CAPTCHA), обвийте вашата заявка в proxy endpoint за автоматична ротация на IP адреси.

Този прогресивен подход поддържа ниски разходи, като същевременно максимизира процента на успешни заявки.

Съвети за производителност

• Използвайте single endpoint по подразбиране и преминавайте към по-високо ниво само при необходимост
• Задайте checkText в browser заявките, за да избегнете чакането на ненужно съдържание
• Задайте maxTries в proxy заявките, за да контролирате поведението при повторен опит (по подразбиране е 5, максимумът е 90)
• Поддържайте разумни стойности за timeout_ms: от 10 до 15 секунди за повечето страници

Следващи стъпки

• API Endpoints: Пълна документация на параметрите
• Scrape a Dynamic Website: Ръководство стъпка по стъпка за browser заявки
• Quick Start: Вашата първа заявка за 30 секунди