Wyszukiwanie w sieci w czasie rzeczywistym dla AI.
BytePlus
Web search and page content retrieval.
Wyszukiwanie w sieci w czasie rzeczywistym dla AI.
Uruchamia wyszukiwanie w sieci w czasie rzeczywistym, stworzone dla agentów AI, i zwraca uszeregowaną listę wyników z tytułami, linkami i fragmentami. Query jest wymagane; zawęź zbiór wyników za pomocą Count (≤ 20), Filter (ogranicz do Sites lub wyklucz BlockHosts), Language i TimeRange. Odpowiedź opakowuje ResponseMetadata.RequestId oraz listę Result z wynikami sieciowymi. Używaj jej do augmentacji pobierania w RAG, monitorowania konkurencji/PR, weryfikacji faktów i pozyskiwania treści; połącz każdy URL wyniku z post_byteplus_fetch, aby pobrać pełną treść strony.
Informacje referencyjne o rozliczaniu
- Rozliczanie: stała podstawa kosztu za udane żądanie.
- Referencyjny szacunek żądania: USD 0.0048.
- Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
Wyłącznie metadane referencyjne — nie stanowią oferty dla konta, gwarantowanej ceny ani limitu wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.
- Typ: stringQuerymaks. długość:400wymagane
Zapytanie wyszukiwania. Wymagane. Maks. 400 znaków; silnik upstream skutecznie ogranicza też do około 50 słów.
- Typ: integerCountmaks.:20
Liczba wyników do zwrócenia. Opcjonalne; domyślnie 10, maksymalnie 20.
- Typ: objectFilter
Opcjonalny filtr wyników. Oba pola to ciągi pełnych domen rozdzielonych znakiem pionowej kreski (maks. 5 w każdym).
- BlockTyp: string
Hosts Wyklucza wyniki z tych pełnych domen. Rozdzielone znakiem pionowej kreski, maks. 5, np. "reddit.com|quora.com".
- SitesTyp: string
Ogranicza wyniki do tych pełnych domen. Rozdzielone znakiem pionowej kreski, maks. 5, np. "bytedance.com|byteplus.com". (Wysłanie tablicy zwraca 10400 Invalid Parameter.)
- Typ: stringLanguage
Opcjonalna wskazówka językowa w formacie upstream, np. EN, ZH-HANS, ZH-HANT.
- Time
Range Opcjonalne okno świeżości. Jedno z nazwanych okien OneDay / OneWeek / OneMonth / OneYear albo zakres niestandardowy "YYYY-MM-DD..YYYY-MM-DD". Pomiń, aby nie filtrować według czasu. UWAGA: wartości takie jak "week"/"month" są po stronie upstream po cichu ignorowane.
- Typ: string enum
Opcjonalne okno świeżości. Jedno z nazwanych okien OneDay / OneWeek / OneMonth / OneYear albo zakres niestandardowy "YYYY-MM-DD..YYYY-MM-DD". Pomiń, aby nie filtrować według czasu. UWAGA: wartości takie jak "week"/"month" są po stronie upstream po cichu ignorowane.
wartości- One
Day - One
Week - One
Month - One
Year
- Typ: object200
Wyszukiwanie zakończone powodzeniem.
Resultzawiera uszeregowane wyniki sieciowe.- Typ: objectResponse
Metadata Metadane żądania upstream.
- ActionTyp: string
- RegionTyp: string
- RequestTyp: string
Id Unikalny identyfikator tego żądania.
- ServiceTyp: string
- VersionTyp: string
- Typ: objectResult
Dane wyniku wyszukiwania.
- ChoicesTyp: array object[] | null
Zarezerwowane; null, jeśli nie dotyczy.
Pusty obiekt - LogTyp: string
Id Identyfikator logu upstream (równy ResponseMetadata.RequestId).
- ResultTyp: integer
Count Liczba zwróconych wyników sieciowych.
- SearchTyp: object
Context Echo rozstrzygniętego kontekstu zapytania.
- OriginTyp: string
Query - SearchTyp: string
Type
- TimeTyp: integer
Cost Czas przetwarzania upstream w milisekundach.
- UsageTyp: object | null
Zarezerwowane; null, jeśli nie dotyczy.
- WebTyp: array object[]
Results Uszeregowana lista wyników sieciowych.
- IdTyp: string
Nieprzejrzysty identyfikator wyniku.
- LogoTyp: string
Url Podpisany URL logo witryny (ograniczony czasowo).
- PublishTyp: string
Time Czas publikacji w ISO 8601 (może być pusty).
- PublishTyp: integer
Time Unix Czas publikacji w sekundach uniksowych (0, jeśli nieznany).
- SiteTyp: string
Name Nazwa witryny źródłowej (może być pusta).
- SnippetTyp: string
Krótki fragment tekstu ze strony.
- SortTyp: integer
Id Pozycja wyniku liczona od 1.
- SummaryTyp: string
Dłuższe podsumowanie treści strony.
- TitleTyp: string
Tytuł wyniku.
- UrlTyp: string
URL wyniku.
application/json - 400
Nie można przetworzyć żądania. Sprawdź parametry żądania.
- 401
Wymagany jest prawidłowy klucz API Felo.
- 402
Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
- 403
Konto nie ma uprawnień do wykonania tej operacji.
- 429
Osiągnięto limit żądań lub wydatków.
- 502
Usługa nie mogła ukończyć żądania.
- 503
API lub usługa rozliczeniowa jest tymczasowo niedostępna.
- 504
Upłynął limit czasu usługi podczas przetwarzania żądania.
- default
Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy
application/json
curl https://openapi.felo.ai/v1/beta/byteplus/web-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"Query": "OpenAI news"
}'
{
"ResponseMetadata": {
"RequestId": "20260904155503A787EC832774768DC56F",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"ResultCount": 3,
"WebResults": [
{
"Id": "19b903d59c017bbb04c7832574500d49",
"SortId": 1,
"Title": "OpenAI News | OpenAI",
"SiteName": "OpenAI",
"Url": "https://openai.com/news/",
"Snippet": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"Summary": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"PublishTime": "2026-09-03T07:50:20+08:00",
"PublishTimeUnix": 1788393020,
"LogoUrl": "https://p16-bpsearch-sign.ibyteimg.com/...<signed>"
}
],
"SearchContext": {
"OriginQuery": "OpenAI latest news",
"SearchType": "web"
},
"TimeCost": 935,
"LogId": "20260904155503A787EC832774768DC56F",
"Choices": null,
"Usage": null
}
}