> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Posts

> Search Posts 엔드포인트를 사용하면 강력한 쿼리 연산자로 특정 조건에 매칭되는 게시물을 찾을 수 있습니다. search를 다루는 X API v2 standard 티어 레퍼런스입니다.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

Search Posts 엔드포인트를 사용하면 강력한 쿼리 연산자로 특정 조건에 매칭되는 게시물을 찾을 수 있습니다. 키워드, 해시태그, 멘션, URL 등을 검색하세요.

## 개요

X는 시간 범위와 접근 요구사항이 다른 두 가지 search 엔드포인트를 제공합니다:

<CardGroup cols={2}>
  <Card title="Recent Search" icon="clock">
    **최근 7일**의 게시물을 검색합니다. 모든 개발자가 사용할 수 있습니다.
  </Card>

  <Card title="Full-Archive Search" icon="vault">
    2006년까지 거슬러 올라간 **전체 아카이브**를 검색합니다. Pay-per-use 및 Enterprise 고객이 사용할 수 있습니다.
  </Card>
</CardGroup>

***

## 사용 사례

* **브랜드 모니터링** — 브랜드나 제품에 대한 멘션 추적
* **트렌드 분석** — 주제나 이벤트를 둘러싼 대화 분석
* **리서치** — 학술 또는 시장 조사를 위한 데이터 수집
* **실시간 리스닝** — 새 게시물에 반응하는 애플리케이션 구축

***

## 엔드포인트

| Method | Endpoint                                                      | Description    | Access                  |
| :----- | :------------------------------------------------------------ | :------------- | :---------------------- |
| GET    | [`/2/tweets/search/recent`](/x-api/posts/search-recent-posts) | 최근 7일간의 게시물 검색 | 모든 개발자                  |
| GET    | [`/2/tweets/search/all`](/x-api/posts/search-all-posts)       | 전체 게시물 아카이브 검색 | Pay-per-use, Enterprise |

***

## 쿼리 연산자

게시물 속성을 매칭하는 연산자로 쿼리를 작성합니다:

```
(AI OR "artificial intelligence") lang:en -is:retweet has:links
```

<AccordionGroup>
  <Accordion title="키워드 연산자">
    | Operator | Example              | Description       |
    | :------- | :------------------- | :---------------- |
    | Keyword  | `python`             | 해당 단어가 포함된 게시물 매칭 |
    | Phrase   | `"machine learning"` | 정확한 구문 매칭         |
    | Hashtag  | `#AI`                | 해시태그가 있는 게시물 매칭   |
    | Mention  | `@XDevelopers`       | 사용자를 멘션하는 게시물 매칭  |
  </Accordion>

  <Accordion title="사용자 연산자">
    | Operator       | Example          | Description  |
    | :------------- | :--------------- | :----------- |
    | `from:`        | `from:elonmusk`  | 사용자의 게시물     |
    | `to:`          | `to:XDevelopers` | 사용자에 대한 답글   |
    | `retweets_of:` | `retweets_of:X`  | 사용자 게시물의 리트윗 |
  </Accordion>

  <Accordion title="콘텐츠 연산자">
    | Operator       | Example          | Description    |
    | :------------- | :--------------- | :------------- |
    | `has:images`   | `cat has:images` | 이미지가 있는 게시물    |
    | `has:videos`   | `has:videos`     | 동영상이 있는 게시물    |
    | `has:links`    | `has:links`      | 링크가 있는 게시물     |
    | `has:mentions` | `has:mentions`   | 멘션이 있는 게시물     |
    | `url:`         | `url:github.com` | 특정 URL이 있는 게시물 |
  </Accordion>

  <Accordion title="필터 연산자">
    | Operator      | Example       | Description |
    | :------------ | :------------ | :---------- |
    | `lang:`       | `lang:en`     | 특정 언어의 게시물  |
    | `-is:retweet` | `-is:retweet` | 리트윗 제외      |
    | `-is:reply`   | `-is:reply`   | 답글 제외       |
    | `is:verified` | `is:verified` | 인증 사용자의 게시물 |
  </Accordion>
</AccordionGroup>

<Card title="전체 연산자 레퍼런스" icon="list-check" href="/x-api/posts/search/integrate/operators">
  사용 가능한 모든 연산자와 액세스 요구사항 보기
</Card>

***

## Recent Search

**최근 7일**의 게시물을 검색합니다. 모든 개발자가 사용할 수 있습니다.

### 기능

* 요청당 최대 100개 게시물
* 큰 결과 집합용 페이지네이션
* 모든 core 쿼리 연산자
* 512자 쿼리 길이 (Enterprise의 경우 4,096자)

<CardGroup cols={2}>
  <Card title="퀵스타트" icon="https://mintcdn.com/x-preview/oR-aRNyj1BKPJtxM/icons/xds/icon-rocket.svg?fit=max&auto=format&n=oR-aRNyj1BKPJtxM&q=85&s=b978d7a9225de31709efbbed5b84e92d" href="/x-api/posts/search/quickstart/recent-search" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    첫 recent search 요청 만들기
  </Card>

  <Card title="API 레퍼런스" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-code.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=488e23401b19225b89acc0136d242219" href="/x-api/posts/search-recent-posts" width="24" height="24" data-path="icons/xds/icon-code.svg">
    전체 엔드포인트 문서
  </Card>
</CardGroup>

***

## Full-Archive Search

2006년 3월까지 거슬러 올라가는 **전체 게시물 아카이브**를 검색합니다.

<Note>
  Full-archive search는 pay-per-use 및 Enterprise 고객이 사용할 수 있습니다.
</Note>

### 기능

* 요청당 최대 500개 게시물
* 전체 게시물 히스토리 접근
* 사용 가능한 모든 쿼리 연산자
* 1,024자 쿼리 길이 (Enterprise의 경우 4,096자)

<CardGroup cols={2}>
  <Card title="퀵스타트" icon="https://mintcdn.com/x-preview/oR-aRNyj1BKPJtxM/icons/xds/icon-rocket.svg?fit=max&auto=format&n=oR-aRNyj1BKPJtxM&q=85&s=b978d7a9225de31709efbbed5b84e92d" href="/x-api/posts/search/quickstart/full-archive-search" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    첫 full-archive search 요청 만들기
  </Card>

  <Card title="API 레퍼런스" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-code.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=488e23401b19225b89acc0136d242219" href="/x-api/posts/search-all-posts" width="24" height="24" data-path="icons/xds/icon-code.svg">
    전체 엔드포인트 문서
  </Card>
</CardGroup>

***

## 시작하기

<Note>
  **사전 요구사항**

  * 승인된 [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
  * Developer Console 내의 [Project와 App](/resources/fundamentals/developer-apps)
  * App의 [keys and tokens](/resources/fundamentals/authentication)
</Note>

<CardGroup cols={2}>
  <Card title="쿼리 작성" icon="https://mintcdn.com/x-preview/cfyQtgCdwk8p69aa/icons/xds/icon-search.svg?fit=max&auto=format&n=cfyQtgCdwk8p69aa&q=85&s=8c11ad89387b7c09ced1553d5c232834" href="/x-api/posts/search/integrate/build-a-query" width="24" height="24" data-path="icons/xds/icon-search.svg">
    쿼리 구문 및 연산자 익히기
  </Card>

  <Card title="페이지네이션" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-arrow-right.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=88e933002782dbdeb204043cedef033e" href="/x-api/posts/search/integrate/paginate" width="24" height="24" data-path="icons/xds/icon-arrow-right.svg">
    큰 결과 집합 탐색
  </Card>

  <Card title="통합 가이드" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-book.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=22ac564792481d14ae36a941546039c8" href="/x-api/posts/search/integrate/overview" width="24" height="24" data-path="icons/xds/icon-book.svg">
    핵심 개념 및 모범 사례
  </Card>

  <Card title="샘플 코드" icon="github" href="https://github.com/xdevplatform/Twitter-API-v2-sample-code">
    동작하는 코드 예제
  </Card>
</CardGroup>