Serper를 통한 Google 웹 검색 결과입니다. 자연 검색 결과, 지식 그래프, 답변 박스, 관련 질문, 연관 검색어를 반환합니다. 검색 1회 3 크레딧입니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "serper/search",
"input": {
"q": "AI video generation API",
"gl": "kr",
"hl": "ko",
"num": 10
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
q | string | Yes | - | 검색어입니다. |
gl | string | No | - | 결과 국가입니다. 소문자 ISO 3166-1 코드로 지정합니다 (예: kr, us). 기본 us. |
hl | string | No | - | 결과 언어입니다 (예: ko, en). 기본 en. |
location | string | No | - | 이 위치에서 검색한 것처럼 결과를 받습니다 (예: Seoul, South Korea). |
num | integer | No | 10 | 결과 수입니다. 10개까지 Serper 1크레딧이며, 11-100은 2크레딧으로 예약한 뒤 Serper 실제 차감분으로 정산합니다. |
page | integer | No | 1 | 결과 페이지입니다 (1 = 첫 페이지). |
tbs | string | No | - | 기간 필터입니다 — 지난 1시간/하루/1주/1개월/1년. 생략하면 전체 기간. qdr:hqdr:dqdr:wqdr:mqdr:y |
autocorrect | boolean | No | true | Google 이 검색어 오타를 자동 교정합니다. |
POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
가장 흔한 옵션으로 보내는 기본 요청입니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "serper/search",
"input": {
"q": "AI video generation API",
"gl": "kr",
"hl": "ko",
"num": 10
}
}'