Felo API PlatformFelo API Platform
Все эндпоинты 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 enum
    константа:  
    false
    значения
    • false
  • limit
    Тип: integer
    мин.:  
    1
    макс.:  
    100

    Integer numbers.

  • sources
    Тип: array string[] 1…1enum
    константа:  
    [ "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

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    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.

Нужна помощь?