Felo API PlatformFelo API Platform

Data API / BytePlus / Web Search

AI-oriented real-time web search.

Run a real-time web search built for AI agents and return a ranked list of titled results with links and snippets. Query is required; narrow the result set with Count (≤ 20), Filter (restrict to Sites or exclude BlockHosts), Language, and TimeRange. The response wraps ResponseMetadata.RequestId and a Result list of web results. Use it for RAG retrieval augmentation, competitive/PR monitoring, fact-checking, and content sourcing; pair each result URL with post_byteplus_fetch to pull full page content.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

  • QuerystringОбязательный

    The search query. Required. Max 400 characters; the upstream engine also effectively caps around 50 words.

  • CountintegerНеобязательный

    Number of results to return. Optional; default 10, maximum 20.

  • FilterobjectНеобязательный

    Optional result filter. Both fields are pipe-separated strings of full domains (max 5 each).

  • SitesstringНеобязательный

    Restrict results to these full domains. Pipe-separated, max 5, e.g. "bytedance.com|byteplus.com". (Sending an array returns 10400 Invalid Parameter.)

  • BlockHostsstringНеобязательный

    Exclude results from these full domains. Pipe-separated, max 5, e.g. "reddit.com|quora.com".

  • LanguagestringНеобязательный

    Optional language hint in the upstream format, e.g. EN, ZH-HANS, ZH-HANT.

  • TimeRangeНеобязательный

    Допустимые значения: OneDay · OneWeek · OneMonth · OneYear

    Optional recency window. One of the named windows OneDay / OneWeek / OneMonth / OneYear, or a custom range "YYYY-MM-DD..YYYY-MM-DD". Omit for no time filter. NOTE: values like "week"/"month" are silently ignored upstream.

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/byteplus/web-search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "Query": "<string>",
  "Count": 0,
  "Filter": {},
  "Language": "<string>",
  "TimeRange": {}
}'

Ответ

Поля ответа

  • ResponseMetadataobjectНеобязательный

    Upstream request metadata.

  • RequestIdstringНеобязательный

    Unique identifier for this request.

  • ActionstringНеобязательный
  • VersionstringНеобязательный
  • ServicestringНеобязательный
  • RegionstringНеобязательный
  • ResultobjectНеобязательный

    Search result payload.

  • ResultCountintegerНеобязательный

    Number of web results returned.

  • WebResultsobject[]Необязательный

    Ranked list of web results.

  • IdstringНеобязательный

    Opaque result id.

  • SortIdintegerНеобязательный

    1-based rank of the result.

  • TitlestringНеобязательный

    Result title.

  • SiteNamestringНеобязательный

    Source site name (may be empty).

  • UrlstringНеобязательный

    Result URL.

  • SnippetstringНеобязательный

    Short text snippet from the page.

  • SummarystringНеобязательный

    Longer summary of the page content.

  • PublishTimestringНеобязательный

    Publish time in ISO 8601 (may be empty).

  • PublishTimeUnixintegerНеобязательный

    Publish time as Unix seconds (0 if unknown).

  • LogoUrlstringНеобязательный

    Signed site logo URL (time-limited).

  • SearchContextobjectНеобязательный

    Echo of the resolved query context.

  • OriginQuerystringНеобязательный
  • SearchTypestringНеобязательный
  • TimeCostintegerНеобязательный

    Upstream processing time in milliseconds.

  • LogIdstringНеобязательный

    Upstream log id (equals ResponseMetadata.RequestId).

  • ChoicesНеобязательный

    Reserved; null unless applicable.

  • UsageНеобязательный

    Reserved; null unless applicable.