WebExtrator Інтелектуальний API для вилучення даних – Посібник із інтеграції - Ace Data Cloud

POST https://api.acedata.cloud/webextrator/extract Виконує вилучення контенту на основі /webextrator/render. Окрім усіх параметрів render API, додатково підтримує:

Поле	Тип	Обов’язкове	За замовчуванням	Опис
`expected_type`	string	❌	`markdown`	Очікуваний тип вилученого результату: `markdown` / `article` / `text` / `links` / `structured`
`enable_llm`	boolean	❌	false	Увімкнення LLM для постобробки (підходить для `article` / `structured`)
`instruction`	string	❌	-	Інструкції для LLM щодо вилучення, наприклад «вилучити назву товару, ціну, характеристики»

Синхронна відповідь

{
  "success": true,
  "task_id": "550e8400-...",
  "trace_id": "550e8400-...",
  "started_at": "2026-05-02T10:30:00.123Z",
  "finished_at": "2026-05-02T10:30:08.789Z",
  "elapsed": 8.666,
  "data": {
    "kind": "extract",
    "expected_type": "article",
    "url": "https://example.com/post/1",
    "title": "Приклад статті",
    "author": "Чжан Сан",
    "published_at": "2026-05-01",
    "content": "# Приклад статті\n\nОсновний текст ...",
    "summary": "У цій статті описано ..."
  }
}

Асинхронний режим, коди помилок та правила тарифікації повністю збігаються з /webextrator/render.

Приклад: вилучення основного тексту статті (з увімкненим LLM)

curl -X POST https://api.acedata.cloud/webextrator/extract \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/news/1",
    "expected_type": "article",
    "enable_llm": true
  }'

Приклад: асинхронне вилучення + користувацька структурована витяг

curl -X POST https://api.acedata.cloud/webextrator/extract \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://shop.example.com/item/123",
    "expected_type": "structured",
    "enable_llm": true,
    "instruction": "вилучити назву товару, ціну, наявність, URL трьох основних зображень",
    "callback_url": "https://your-domain.com/wbx-callback"
  }'