Felo API PlatformFelo API Platform

Data API / Firecrawl / Search

Run a web search and return ranked results.

Search the web and get back ranked results. query is required; limit sets how many. Returns success, creditsUsed, a request id, and data.web[] with url, title, description and position — titles and snippets only, no page text. Reach for something else when: you want the page text in the same call — searchWeb returns it and answers in a third of the time; you already know the URLs — post_firecrawl_scrape; you want relevance judged by meaning rather than keywords — post_exa_search.

Parameters

No path, query, or header parameters.

Request body

  • querystringRequired

    The search query. Must be non-empty and at most 500 characters.

  • limitintegerOptional

    Maximum number of results to return.

Example request

curl -X POST "https://openapi.felo.ai/v1/beta/firecrawl/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "<string>",
  "limit": 0
}'

Response

Response fields

  • successbooleanOptional

    True when the search succeeded.

  • dataobjectOptional
  • webobject[]Optional

    Ranked web search results.

  • titlestringOptional

    Result title.

  • urlstringOptional

    Result URL.

  • descriptionstringOptional

    Result snippet.

  • creditsUsedintegerOptional

    Firecrawl credits consumed (about 2 per 10 results).