BytePlus
Web search and page content retrieval.
AI 지향 실시간 웹 검색.
AI 에이전트용으로 구축된 실시간 웹 검색을 실행하고 링크와 스니펫이 포함된 제목 있는 결과의 순위 목록을 반환합니다. Query는 필수이며, Count(≤ 20), Filter(Sites로 제한하거나 BlockHosts 제외), Language, TimeRange로 결과 집합을 좁힐 수 있습니다. 응답은 ResponseMetadata.RequestId와 웹 결과의 Result 목록을 감쌉니다. RAG 검색 증강, 경쟁사/PR 모니터링, 팩트 체크, 콘텐츠 소싱에 사용하며, 각 결과 URL을 post_byteplus_fetch와 함께 사용해 전체 페이지 콘텐츠를 가져오세요.
가격 참고
- 과금 방식: 성공한 요청당 고정 원가 기준.
- 참조 요청 추정치: USD 0.0048.
- 참조 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringQuery최대 길이:400필수
검색 쿼리입니다. 필수입니다. 최대 400자이며, 업스트림 엔진도 실질적으로 약 50단어에서 제한됩니다.
- 유형: integerCount최댓값:20
반환할 결과 수입니다. 선택 사항이며 기본값은 10, 최댓값은 20입니다.
- 유형: objectFilter
선택적 결과 필터입니다. 두 필드 모두 전체 도메인을 파이프로 구분한 문자열입니다(각 최대 5개).
- Block유형: string
Hosts 이 전체 도메인의 결과를 제외합니다. 파이프로 구분하며 최대 5개입니다(예: "reddit.com|quora.com").
- Sites유형: string
결과를 이 전체 도메인으로 제한합니다. 파이프로 구분하며 최대 5개입니다(예: "bytedance.com|byteplus.com"). 배열을 전송하면 10400 Invalid Parameter가 반환됩니다.
- 유형: stringLanguage
업스트림 형식의 선택적 언어 힌트입니다(예: EN, ZH-HANS, ZH-HANT).
- Time
Range 선택적 최신성 기간입니다. 지정된 기간인 OneDay / OneWeek / OneMonth / OneYear 중 하나이거나 사용자 지정 범위 "YYYY-MM-DD..YYYY-MM-DD"입니다. 시간 필터를 사용하지 않으려면 생략하세요. 참고: "week"/"month" 같은 값은 업스트림에서 조용히 무시됩니다.
- 유형: string 열거형
선택적 최신성 기간입니다. 지정된 기간인 OneDay / OneWeek / OneMonth / OneYear 중 하나이거나 사용자 지정 범위 "YYYY-MM-DD..YYYY-MM-DD"입니다. 시간 필터를 사용하지 않으려면 생략하세요. 참고: "week"/"month" 같은 값은 업스트림에서 조용히 무시됩니다.
값- One
Day - One
Week - One
Month - One
Year
- 유형: object200
검색에 성공했습니다.
Result에 순위가 매겨진 웹 결과가 들어 있습니다.- 유형: objectResponse
Metadata 업스트림 요청 메타데이터입니다.
- Action유형: string
- Region유형: string
- Request유형: string
Id 이 요청의 고유 식별자입니다.
- Service유형: string
- Version유형: string
- 유형: objectResult
검색 결과 페이로드입니다.
- Choices유형: array object[] | null
예약됨. 해당하는 경우가 아니면 null입니다.
빈 객체 - Log유형: string
Id 업스트림 로그 id입니다(ResponseMetadata.RequestId와 동일).
- Result유형: integer
Count 반환된 웹 결과 수입니다.
- Search유형: object
Context 확정된 쿼리 컨텍스트를 그대로 반환한 값입니다.
- Origin유형: string
Query - Search유형: string
Type
- Time유형: integer
Cost 업스트림 처리 시간입니다(밀리초).
- Usage유형: object | null
예약됨. 해당하는 경우가 아니면 null입니다.
- Web유형: array object[]
Results 순위가 매겨진 웹 결과 목록입니다.
- Id유형: string
불투명한 결과 id입니다.
- Logo유형: string
Url 서명된 사이트 로고 URL입니다(시간 제한 있음).
- Publish유형: string
Time ISO 8601 형식의 게시 시간입니다(비어 있을 수 있음).
- Publish유형: integer
Time Unix 게시 시간입니다(Unix 초, 알 수 없으면 0).
- Site유형: string
Name 출처 사이트 이름입니다(비어 있을 수 있음).
- Snippet유형: string
페이지에서 발췌한 짧은 텍스트 스니펫입니다.
- Sort유형: integer
Id 결과의 순위입니다(1부터 시작).
- Summary유형: string
페이지 콘텐츠의 긴 요약입니다.
- Title유형: string
결과 제목입니다.
- Url유형: string
결과 URL입니다.
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
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
}
}