# 학술 논문 검색

**API:** Data API

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

**Tags:** Scholar Search

학술 문헌을 검색합니다. ⚠️ 매개변수는 본문이 아니라 **쿼리 문자열**에 넣습니다: `query`(필수), `max_num_results`, 발행 연도 범위를 지정하는 `as_ylo`/`as_yhi`. 검색 `id`와 `title`, `link`, `snippet`, `authors`, `number_of_citations`가 포함된 `results[]`를 반환합니다. 마지막 필드는 일반 웹 검색이 제공할 수 없는 것입니다. 동료 심사 소스가 필요한 질문이나 인용 수가 중요할 때 사용하세요. 시사 및 제품 페이지에는 일반 엔진이 더 적합합니다: `searchWeb`. 둘 다 한 번에 처리하려면 `post_scholar_search_mixed`를 사용하세요. `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_ScholarSearchResponse` (`#/components/schemas/Response8Da310D1D213_ScholarSearchResponse`)

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response8Da310D1D213_ScholarResult

`#/components/schemas/Response8Da310D1D213_ScholarResult`

```json
{
  "type": "object",
  "required": [
    "title",
    "link",
    "snippet",
    "authors",
    "number_of_citations"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "학술 논문 제목"
    },
    "link": {
      "type": "string",
      "format": "uri",
      "description": "전체 논문 접근 URL"
    },
    "snippet": {
      "type": "string",
      "description": "논문의 간단한 요약 또는 초록"
    },
    "authors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "저자 목록"
    },
    "number_of_citations": {
      "type": "integer",
      "minimum": 0,
      "description": "논문이 받은 인용 수"
    },
    "year": {
      "type": "integer",
      "description": "출판 연도",
      "minimum": 1900,
      "maximum": 2030
    },
    "journal": {
      "type": "string",
      "description": "저널 또는 학회 이름"
    }
  }
}
```

### Response8Da310D1D213_ScholarSearchResponse

`#/components/schemas/Response8Da310D1D213_ScholarSearchResponse`

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