# 웹 검색

**API:** Data API

**Endpoint:** `POST /v1/beta/scholar/search/web`

**Tags:** Scholar Search

개방형 웹을 검색하고 간결한 결과 목록을 반환합니다. ⚠️ POST이지만 매개변수는 **쿼리 문자열**에 넣습니다: `query`(필수), `max_num_results`(기본 10, 최대 100), 연도 범위용 `as_ylo`/`as_yhi`. JSON 본문은 허용되지 않습니다. 검색 `id`와 `title`, `link`, `snippet`만 담은 `results[]`를 반환합니다. 장점은 반환량이 적다는 것이며, 무엇이 존재하는지만 알면 되는 에이전트에 적합합니다. 페이지 텍스트는 제공하지 않습니다. 콘텐츠가 필요하면 `searchWeb`이 같은 호출에서 반환합니다. `id`를 보관하세요. `post_scholar_search_explain`에 필요한 값입니다.

### 가격 참고

- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.01.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `as_yhi` | query | no | integer \| null | 출판 연도 상한 |
| `as_ylo` | query | no | integer \| null | 출판 연도 하한 |
| `max_num_results` | query | no | integer, default: 10 | 반환할 최대 검색 결과 수(최대 100) |
| `query` | query | yes | string | 학술 자료 검색 쿼리 |

## Responses

### 200 — 검색 성공 응답

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: `Response8Da310D1D213_WebSearchResponse` (`#/components/schemas/Response8Da310D1D213_WebSearchResponse`)

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response8Da310D1D213_WebResult

`#/components/schemas/Response8Da310D1D213_WebResult`

```json
{
  "type": "object",
  "required": [
    "title",
    "link",
    "snippet"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "웹 페이지 제목"
    },
    "link": {
      "type": "string",
      "format": "uri",
      "description": "웹 페이지 접근 URL"
    },
    "snippet": {
      "type": "string",
      "description": "웹 페이지 콘텐츠의 간단한 요약 또는 미리보기"
    },
    "display_url": {
      "type": "string",
      "description": "표시용 URL"
    },
    "published_date": {
      "type": "string",
      "format": "date-time",
      "description": "웹 페이지 게시 날짜"
    }
  }
}
```

### Response8Da310D1D213_WebSearchResponse

`#/components/schemas/Response8Da310D1D213_WebSearchResponse`

```json
{
  "type": "object",
  "required": [
    "id",
    "results"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "검색 요청의 고유 식별자"
    },
    "results": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response8Da310D1D213_WebResult"
      },
      "description": "웹 검색 결과 목록"
    }
  }
}
```