---
description: 검색 엔진 관련 API
---

# Search API

## 최근 트렌드 우선 검색 엔진

<mark style="color:green;">`POST`</mark> `https://soojle.io/priority_search/<int:num>`

최근 트렌드  검색엔진

#### Path Parameters

| Name | Type    | Description                         |
| ---- | ------- | ----------------------------------- |
| num  | integer | <p>반환받을 post의 개수<br>(최대 10000개)</p> |

#### Headers

| Name          | Type   | Description          |
| ------------- | ------ | -------------------- |
| Authorization | string | "Bearer " + \<token> |

#### Request Body

| Name   | Type   | Description |
| ------ | ------ | ----------- |
| search | string | 검색어         |

{% tabs %}
{% tab title="200  검색 결과 반환" %}
```javascript
1. 성공
{
    "result":"success",
    "search_result":<json_array:Post>
}
/* Post 규격 */
/*{
"_id":<obi>,
"title": <string>,
"date":" <Datetime>,
"img": <string>,
"fav_cnt":<int>,
"view": <int>,
"url":<string>,
"end_date: <Datetime>
}*/
```
{% endtab %}

{% tab title="500  내부 서버 에러" %}
```
{
    "result":"fail"
}
```
{% endtab %}
{% endtabs %}

## 카테고리 검색.ver1 (미사용)

<mark style="color:green;">`POST`</mark> `https://soojle.io/category_search/<int:type_check>/<int:num>`

토픽별 검색

#### Path Parameters

| Name        | Type    | Description                                                              |
| ----------- | ------- | ------------------------------------------------------------------------ |
| type\_check | integer | <p>1: 진로&#x26;구인<br>2: 공모전&#x26;행사 + 동아리&#x26;모임<br>3: 나머지<br>4: 커뮤니</p> |
| num         | integer | <p>반환받을 post의 개수<br>(최대 50000개)</p>                                      |

#### Headers

| Name          | Type   | Description          |
| ------------- | ------ | -------------------- |
| Authorization | string | "Bearer " + \<token> |

#### Request Body

| Name   | Type   | Description |
| ------ | ------ | ----------- |
| search | string | 검색어         |

{% tabs %}
{% tab title="200 " %}
```javascript
1. 성공
{
    "result":"success",
    "search_result":<json_array:Post>
}
/* Post 규격 */
/*{
"_id":<obi>,
"title": <string>,
"date":" <Datetime>,
"img": <string>,
"fav_cnt":<int>,
"view": <int>,
"url":<string>,
"end_date: <Datetime>
}*/
```
{% endtab %}
{% endtabs %}

## 카테고리 검색.ver2

<mark style="color:green;">`POST`</mark> `https://soojle.io/category_search/<string:category_name>/<int:num>`

토픽별 검색

#### Path Parameters

| Name           | Type    | Description                                                                            |
| -------------- | ------- | -------------------------------------------------------------------------------------- |
| category\_name | string  | <p>대학교<br>동아리&#x26;모임<br>공모전&#x26;행사<br>진로&#x26;구인<br>자유<br>일반 (category_name: 예외)</p> |
| num            | integer | <p>반환받을 post의 개수<br>(1000 미만 권장)</p>                                                   |

#### Headers

| Name          | Type   | Description                                         |
| ------------- | ------ | --------------------------------------------------- |
| Authorization | string | <p>"Bearer " + &#x3C;token><br>(로그인 시 로그기록을 위함)</p> |

#### Request Body

| Name   | Type   | Description |
| ------ | ------ | ----------- |
| search | string | 검색어         |

{% tabs %}
{% tab title="200 " %}
```javascript
1. 성공
{
    "result":"success",
    "search_result":<json_array:Post>
}
/* Post 규격 */
/*{
"_id":<obi>,
"title": <string>,
"date":" <Datetime>,
"img": <string>,
"fav_cnt":<int>,
"view": <int>,
"url":<string>,
"end_date: <Datetime>
}*/
```
{% endtab %}
{% endtabs %}

## 도메인 검색

<mark style="color:green;">`POST`</mark> `https://soojle.io/domain_search`

#### Headers

| Name          | Type   | Description          |
| ------------- | ------ | -------------------- |
| Authorization | string | "Bearer " + \<token> |

#### Request Body

| Name   | Type   | Description |
| ------ | ------ | ----------- |
| search | string | 검색어         |

{% tabs %}
{% tab title="200 " %}
```javascript
1. 성공
{
    "result":"success",
    "search_result":<json_array:Post>
}

```
{% endtab %}
{% endtabs %}
