# academic पेपर खोजें

**API:** Data API

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

**Tags:** Scholar Search

academic साहित्य खोजें। ⚠️ पैरामीटर **query string** में जाते हैं, body में नहीं: `query` (आवश्यक), `max_num_results`, और प्रकाशन वर्ष सीमित करने के लिए `as_ylo`/`as_yhi`। search `id` और `results[]` लौटाता है जिनमें `title`, `link`, `snippet`, `authors` और `number_of_citations` हैं — वह अंतिम फ़ील्ड वही है जो सामान्य वेब सर्च नहीं दे सकता। इसका उपयोग तब करें जब प्रश्न के लिए peer-reviewed स्रोत चाहिए या जब citation संख्या मायने रखती है। समसामयिक घटनाओं और उत्पाद पृष्ठों के लिए सामान्य इंजन बेहतर है: `searchWeb`। दोनों एक साथ कवर करने के लिए `post_scholar_search_mixed`। `id` को `post_scholar_search_explain` के लिए रखें।

### मूल्य संदर्भ

- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: 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 | शैक्षणिक सामग्री के लिए सर्च query |

## Responses

### 200 — सफल खोज response

Headers:
- `X-Request-Id` (string) — Felo सहायता से संपर्क करते समय शामिल करने के लिए request पहचानकर्ता।

**application/json**

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

### 400 — request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।

### 401 — एक वैध Felo API key आवश्यक है।

### 402 — request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।

### 403 — खाते को यह ऑपरेशन करने की अनुमति नहीं है।

### 429 — request या खर्च की सीमा तक पहुँच गए हैं।

### 502 — सेवा request पूरा नहीं कर सकी।

### 503 — API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।

### 504 — request संसाधित करते समय सेवा का समय समाप्त हो गया।

### default — त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

**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": "academic पेपर का शीर्षक"
    },
    "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": "academic पेपर परिणामों की सूची"
    }
  }
}
```
