Felo API PlatformFelo API Platform
Усі endpoint Firecrawl
v0.2.0-beta
OpenAPI 3.1.0

Запуск вебпошуку з поверненням ранжованих результатів.

Сервер:https://openapi.felo.ai
Клієнтські бібліотеки

Firecrawl

​

Search, scrape, map, file parsing and asynchronous crawling.

Firecrawl Операції

Запуск вебпошуку з поверненням ранжованих результатів.

​

Шукає у вебі й повертає ранжовані результати. query обов'язковий; limit задає кількість. Повертає success, creditsUsed, id запиту і data.web[] з url, title, description і position — лише заголовки та снипети, без тексту сторінок. Зверніться до іншого інструмента, коли: потрібен текст сторінки в тому ж виклику — searchWeb повертає його і відповідає втричі швидше; URL уже відомі — post_firecrawl_scrape; релевантність треба оцінювати за змістом, а не за ключовими словами — post_exa_search.

Довідкові ціни

  • Тарифікація: тарифікована кількість результатів.
  • Довідкова оцінка запиту: USD 0.002142.
  • Базова вартість одиниці: USD 0.001071.
  • Одиниця ресурсу: firecrawl_credit.
  • Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.
  • Базові вартості не визначають остаточну ціну для клієнта, зокрема коли вони дорівнюють нулю.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло
обов'язкове
application/json
  • query
    Тип: string
    мінімальна довжина:  
    1
    максимальна довжина:  
    2000
    обов'язкове
  • enterprise
    Тип: boolean перелік
    константа:  
    false
    значення
    • false
  • limit
    Тип: integer
    мін.:  
    1
    макс.:  
    100

    Integer numbers.

  • sources
    Тип: array string[] 1…1перелік
    константа:  
    [ "web" ]
    значення
    • web
Відповіді
  • 200
    Тип: object

    Пошук виконано успішно.

    • creditsUsed
      Тип: integer

      Витрачено кредитів Firecrawl (близько 2 на 10 результатів).

    • data
      Тип: object
      • web
        Тип: array object[]

        Ранжовані результати вебпошуку.

        • description
          Тип: string

          Фрагмент результату.

        • title
          Тип: string

          Заголовок результату.

        • url
          Тип: string

          URL результату.

    • success
      Тип: boolean

      true, якщо пошук виконано успішно.

    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    application/json
Request Example for post/v1/beta/firecrawl/search
curl https://openapi.felo.ai/v1/beta/firecrawl/search \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "enterprise": false,
  "limit": 10,
  "query": "nike",
  "sources": [
    "web"
  ]
}'
{
  "success": true,
  "data": {
    "web": [
      {
        "title": "string",
        "url": "string",
        "description": "string"
      }
    ]
  },
  "creditsUsed": 1
}
Run a web search and return ranked results.