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

# メンション検索

> 指定ユーザー名に言及するツイートを1ページ最大20件、デフォルトでは新しい順で返します。検索機能の中で最も豊富なフィルターがあり、「いいね」、返信、リツイートの最小数と期間を指定できます。`popular`または`latest`順にも対応します。



## OpenAPI

````yaml /openapi-ja.json post /mentions
openapi: 3.0.3
info:
  contact: {}
  title: Sorsa.io API
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /mentions:
    post:
      tags:
        - 検索
      summary: メンション検索
      description: >-
        指定ユーザー名に言及するツイートを1ページ最大20件、デフォルトでは新しい順で返します。検索機能の中で最も豊富なフィルターがあり、「いいね」、返信、リツイートの最小数と期間を指定できます。`popular`または`latest`順にも対応します。
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/search.SearchMentionsReq'
        description: queryは必須。next_cursorは任意。
        required: true
        x-originalParamName: payload
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.TweetsResponse'
          description: 成功
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 不正なリクエスト
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 認証失敗
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: アクセス拒否
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 見つかりません
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: リクエスト過多
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 内部サーバーエラー
      security:
        - ApiKeyAuth: []
components:
  schemas:
    search.SearchMentionsReq:
      properties:
        min_likes:
          example: 100
          type: integer
        min_replies:
          example: 100
          type: integer
        min_retweets:
          example: 100
          type: integer
        next_cursor:
          example: JKHSJFHADUYJKSDy2y3u123
          type: string
        order:
          example: popular
          type: string
        query:
          example: elonmusk
          type: string
        since_date:
          example: '2026-01-01'
          type: string
        until_date:
          example: '2026-01-01'
          type: string
      type: object
    common.TweetsResponse:
      properties:
        next_cursor:
          description: 次のページを取得するカーソル。続きがなければnullまたは省略。
          type: string
        tweets:
          description: Tweetオブジェクトの配列。
          items:
            $ref: '#/components/schemas/common.Tweet'
          type: array
      type: object
    handler.ErrorResponse:
      properties:
        message:
          type: string
      type: object
    common.Tweet:
      properties:
        bookmark_count:
          description: ツイートがブックマークされた回数。
          example: 15
          type: integer
        conversation_id_str:
          description: 会話スレッドの先頭ツイートID。
          example: '1782368585664626774'
          type: string
        created_at:
          description: ツイート投稿日時。ISO 8601形式。
          example: '2024-01-15T10:30:00Z'
          type: string
        entities:
          description: ツイートに添付されたメディア、リンク、その他の埋め込みエンティティ。
          items:
            $ref: '#/components/schemas/common.TweetEntity'
          type: array
        full_text:
          description: ツイートの全文。
          example: Hello world
          type: string
        id:
          description: 一意のツイートID。
          example: '1782368585664626774'
          type: string
        in_reply_to_tweet_id:
          description: 返信先ツイートのID。返信でなければnull。
          example: '1782368585664626000'
          type: string
        in_reply_to_username:
          description: 返信先アカウントのユーザー名。
          example: username
          type: string
        is_quote_status:
          description: このツイートが他のツイートを引用しているか。
          example: false
          type: boolean
        is_replies_limited:
          description: 投稿者がこのツイートへの返信を制限しているか。
          example: false
          type: boolean
        is_reply:
          description: このツイートが他のツイートへの返信か。
          example: false
          type: boolean
        lang:
          description: 検出されたツイートの言語コード（例：`en`、`es`）。
          example: en
          type: string
        likes_count:
          description: ツイートの「いいね」の数。
          example: 200
          type: integer
        made_with_ai:
          description: ツイートがAIで作成されたか。
          example: false
          type: boolean
        paid_partnership:
          description: ツイートが有料パートナーシップか。
          example: false
          type: boolean
        quote_count:
          description: 引用ツイート数。
          example: 5
          type: integer
        quoted_status:
          allOf:
            - $ref: '#/components/schemas/common.Tweet'
          description: 引用元のツイート。`is_quote_status`がtrueの場合のみ。
        reply_count:
          description: ツイートへの返信数。
          example: 10
          type: integer
        retweet_count:
          description: リツイート数。
          example: 50
          type: integer
        retweeted_status:
          allOf:
            - $ref: '#/components/schemas/common.Tweet'
          description: リツイート元のツイート。リツイートの場合のみ。
        user:
          allOf:
            - $ref: '#/components/schemas/common.User'
          description: ツイートの投稿者。
        view_count:
          description: 表示回数（インプレッション）。
          example: 10000
          type: integer
      type: object
    common.TweetEntity:
      properties:
        link:
          description: エンティティへの直接URL。
          example: https://t.co/example
          type: string
        preview:
          description: エンティティのプレビューまたはサムネイルURL。
          example: https://pbs.twimg.com/preview
          type: string
        type:
          description: エンティティの種類（例：`photo`、`video`、`url`）。
          example: photo
          type: string
      type: object
    common.User:
      properties:
        bio_urls:
          description: 自己紹介内のURL。
          items:
            type: string
          type: array
        can_dm:
          description: アカウントがDMを受け付けているか。
          example: false
          type: boolean
        created_at:
          description: アカウント作成日時。ISO 8601形式。
          example: '2009-06-02T20:12:29Z'
          type: string
        description:
          description: プロフィールの自己紹介文。
          example: Bio text
          type: string
        display_name:
          description: ユーザーの表示名。
          example: Elon Musk
          type: string
        favourites_count:
          description: このユーザーが「いいね」したツイートの総数。
          example: 1200
          type: integer
        followers_count:
          description: このユーザーをフォローしているアカウント数。
          example: 100000
          type: integer
        followings_count:
          description: このユーザーがフォローしているアカウント数。
          example: 500
          type: integer
        id:
          description: 一意のTwitter/XユーザーID。
          example: '44196397'
          type: string
        location:
          description: ユーザーがプロフィールに記載した所在地。
          example: Austin, TX
          type: string
        media_count:
          description: このユーザーが投稿したメディアの総数。
          example: 300
          type: integer
        pinned_tweet_ids:
          description: ユーザーの固定ツイートのID。
          items:
            type: string
          type: array
        possibly_sensitive:
          description: センシティブな内容を含む可能性があると指定されているか。
          example: false
          type: boolean
        profile_background_image_url:
          description: ユーザーのプロフィール背景画像のURL。
          example: https://pbs.twimg.com/profile_banners/44196397/123
          type: string
        profile_image_url:
          description: ユーザーのアバター画像のURL。
          example: https://pbs.twimg.com/profile_images/123/photo.jpg
          type: string
        protected:
          description: アカウントのツイートが保護されている（非公開）か。
          example: false
          type: boolean
        tweets_count:
          description: このユーザーが投稿したツイートの総数。
          example: 5000
          type: integer
        username:
          description: 現在のTwitter/Xユーザー名（@なし）。
          example: elonmusk
          type: string
        verified:
          description: アカウントに認証バッジがあるか。
          example: true
          type: boolean
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````