bldinit Threads Rest API

The threads-rest API from bldinit — 15 operation(s) for threads-rest.

GitHub OpenAPI

Operations 15

GET /api/v1/threads/me Threads 프로필 조회 #
GET /api/v1/threads/{threads_user_id}/threads 내 Threads 게시물 목록 #
GET /api/v1/threads/{threads_media_id} Threads 게시물 상세 #
GET /api/v1/threads/{threads_user_id}/threads_publishing_limit Threads 발행 한도 조회 (24h 잔여) #
POST /api/v1/threads/{threads_user_id}/threads/text 텍스트 게시물 container 생성 (publishing 1단계) #
POST /api/v1/threads/{threads_user_id}/threads/image 이미지 게시물 container 생성 (publishing 1단계) #
POST /api/v1/threads/{threads_user_id}/threads/video 동영상 게시물 container 생성 (publishing 1단계) #
POST /api/v1/threads/{threads_user_id}/threads_publish Container publish (★ irreversible — public 노출) #
POST /api/v1/threads/me/threads/reply 답글 container 생성 (publishing 1단계) #
GET /api/v1/threads/{threads_media_id}/replies 게시물 답글 목록 #
POST /api/v1/threads/{threads_reply_id}/manage_reply 답글 숨김 / 숨김 해제 (토글) #
GET /api/v1/threads/{threads_media_id}/insights 게시물 인사이트 (likes / reposts / quotes / replies) #
GET /api/v1/threads/{threads_user_id}/threads_insights 계정 인사이트 (views / likes / followers_count 등) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-threads-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-threads-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Threads Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: threads-rest
paths:
  /api/v1/threads/me:
    get:
      tags:
      - threads-rest
      summary: Threads 프로필 조회
      description: '인증된 사용자의 Threads 프로필 metadata —

        id / username / name / is_verified / threads_biography 등.


        Native pass-through.'
      operationId: threads_get_profile
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads:
    get:
      tags:
      - threads-rest
      summary: 내 Threads 게시물 목록
      description: '인증된 Threads 계정의 게시물 list.

        ``after`` cursor 로 pagination.


        Native pass-through.'
      operationId: threads_list_threads
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: until
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Until
      - name: after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: After
      - name: before
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Before
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_media_id}:
    get:
      tags:
      - threads-rest
      summary: Threads 게시물 상세
      description: '특정 게시물의 metadata.


        Native pass-through.'
      operationId: threads_get_thread
      parameters:
      - name: threads_media_id
        in: path
        required: true
        schema:
          type: string
          title: Threads Media Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads_publishing_limit:
    get:
      tags:
      - threads-rest
      summary: Threads 발행 한도 조회 (24h 잔여)
      description: '24시간 게시물 발행 한도 조회.

        ``quota_usage`` (사용량) + ``config`` (``quota_total`` 250 / ``quota_duration`` 86400초) 반환.

        발행 전 잔여 한도 확인 용도.


        **응답 shape**: ``data[0].quota_usage`` / ``data[0].config.quota_total`` / ``data[0].config.quota_duration``.


        Native pass-through.'
      operationId: threads_get_publishing_limit
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads/text:
    post:
      tags:
      - threads-rest
      summary: 텍스트 게시물 container 생성 (publishing 1단계)
      description: '**Publishing 2-step 의 1단계** — 텍스트 게시물 container 생성.

        ``creation_id`` 발급 후 ``threads_publish_container`` 로 실제 publish.


        Recoverable — staged container (24h 이내 publish 안 하면 자동 expire).

        발행 전 외부 노출 X.


        **경로 매핑**: 실제 Threads API endpoint = ``POST /{threads_user_id}/threads``

        에 ``media_type=TEXT`` body param. mcpweave 경로 명시적 분리 (D5 synthetic path).


        Native pass-through.'
      operationId: threads_create_text_container
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads/image:
    post:
      tags:
      - threads-rest
      summary: 이미지 게시물 container 생성 (publishing 1단계)
      description: '**Publishing 2-step 의 1단계** — 이미지 게시물 container 생성.

        ``image_url`` 은 publicly accessible URL (JPEG/PNG, max 8MB, 320-1440px).


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        **경로 매핑**: 실제 endpoint = ``POST /{threads_user_id}/threads`` +

        ``media_type=IMAGE``. mcpweave 경로 명시적 분리 (D5 synthetic path).


        Native pass-through.'
      operationId: threads_create_image_container
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads/video:
    post:
      tags:
      - threads-rest
      summary: 동영상 게시물 container 생성 (publishing 1단계)
      description: '**Publishing 2-step 의 1단계** — 동영상 게시물 container 생성.

        ``video_url`` = publicly accessible MP4/MOV URL (H.264/HEVC, max 1GB, 최대 300초).


        Video 처리 완료 전 publish 시 오류 발생 — ``GET /{container_id}?fields=status``

        로 ``FINISHED`` 확인 후 publish 권장.


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        **경로 매핑**: 실제 endpoint = ``POST /{threads_user_id}/threads`` +

        ``media_type=VIDEO``. mcpweave 경로 명시적 분리 (D5 synthetic path).


        Native pass-through.'
      operationId: threads_create_video_container
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads/carousel_item:
    post:
      tags:
      - threads-rest
      summary: 캐러셀 child container 생성 (1단계)
      description: '캐러셀 게시물의 **개별 슬라이드 container** 생성. ``is_carousel_item=true`` 필수.

        ``image_url`` (이미지) 또는 ``video_url`` (동영상) 중 하나 제공.

        반환된 ``id`` 를 ``threads_create_carousel_container`` 의 ``children`` 에 사용.


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        **경로 매핑**: 실제 endpoint = ``POST /{threads_user_id}/threads`` +

        ``is_carousel_item=true``. mcpweave 경로 명시적 분리 (D5 synthetic path).


        Native pass-through.'
      operationId: threads_create_carousel_item
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads/carousel:
    post:
      tags:
      - threads-rest
      summary: 캐러셀 container 생성 (2단계, 발행 전)
      description: '**캐러셀 발행 흐름의 2단계** — child container ID 목록을 묶어 carousel container 생성.

        생성 후 ``threads_publish_container`` (creation_id=carousel container ID) 로 발행.


        ``children``: child container ID comma-separated 문자열 (2-20개).


        Recoverable — staged container (24h auto-expire, 발행 전 외부 노출 X).


        **경로 매핑**: 실제 endpoint = ``POST /{threads_user_id}/threads`` +

        ``media_type=CAROUSEL`` + ``children``. mcpweave 경로 명시적 분리 (D5 synthetic path).


        Native pass-through.'
      operationId: threads_create_carousel_container
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads_publish:
    post:
      tags:
      - threads-rest
      summary: Container publish (★ irreversible — public 노출)
      description: '**Publishing 2-step 의 2단계** — ``creation_id`` (container_id) 를 받아

        실제 게시. 이 시점에 followers + 공개 viewers 에게 노출.


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: 게시 후 followers

        피드 노출. 삭제 가능하지만 노출 흔적 (캐시 / 인용 / screenshot) 회수 불가.


        발행 전 약 30초 대기 권장 (video 는 status=FINISHED 확인 권장).


        Native pass-through.'
      operationId: threads_publish_container
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/me/threads/reply:
    post:
      tags:
      - threads-rest
      summary: 답글 container 생성 (publishing 1단계)
      description: '**Publishing 2-step 의 1단계** — 답글 container 생성.

        ``reply_to_id`` = 답글을 달 게시물 또는 답글의 Threads media ID.

        container 생성 후 ``threads_publish_container`` 로 발행.


        답글은 250 게시물/24h 한도와 별개 — 1,000 답글/24h 한도.


        Recoverable — staged container (24h auto-expire, 외부 노출 X).


        **경로 매핑**: 실제 endpoint = ``POST /me/threads`` + ``reply_to_id`` body param.

        mcpweave 경로 명시적 분리 (D5 synthetic path, /me 접두사 보존).


        Native pass-through.'
      operationId: threads_create_reply
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_media_id}/replies:
    get:
      tags:
      - threads-rest
      summary: 게시물 답글 목록
      description: '``threads_media_id`` 의 top-level 답글 목록. 중첩 답글은 ``has_replies`` 필드 확인.

        ``reverse=true`` (기본) = 최신순.


        Native pass-through.'
      operationId: threads_list_replies
      parameters:
      - name: threads_media_id
        in: path
        required: true
        schema:
          type: string
          title: Threads Media Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: reverse
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Reverse
      - name: after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: After
      - name: before
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Before
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_reply_id}/manage_reply:
    post:
      tags:
      - threads-rest
      summary: 답글 숨김 / 숨김 해제 (토글)
      description: '답글을 숨기거나 숨김 해제. ``hide=true`` 로 숨김, ``hide=false`` 로 복구.

        답글 작성자 본인에게는 보이지만 다른 사용자에게는 안 보임.


        **Reversible** — hide=false 로 복구 가능. destructive 마킹만 (irreversible X).


        Native pass-through.'
      operationId: threads_hide_reply
      parameters:
      - name: threads_reply_id
        in: path
        required: true
        schema:
          type: string
          title: Threads Reply Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: hide
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Hide
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_media_id}/insights:
    get:
      tags:
      - threads-rest
      summary: 게시물 인사이트 (likes / reposts / quotes / replies)
      description: '게시물 별 metrics. ``metric`` 은 comma-separated.


        Common metrics: ``likes,reposts,quotes,replies,views``.

        모든 미디어 metrics 는 ``period: "lifetime"`` 로 반환.


        Native pass-through.'
      operationId: threads_get_post_insights
      parameters:
      - name: threads_media_id
        in: path
        required: true
        schema:
          type: string
          title: Threads Media Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: metric
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Metric
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/threads/{threads_user_id}/threads_insights:
    get:
      tags:
      - threads-rest
      summary: 계정 인사이트 (views / likes / followers_count 등)
      description: '계정 단위 metrics. ``metric`` + ``since`` / ``until`` (Unix timestamp).


        Common metrics:

        - ``views`` (시간별 조회수) — since/until 범위 필수

        - ``likes`` / ``reposts`` / ``quotes`` / ``replies`` (집계)

        - ``followers_count`` — since/until 무시 (현재 스냅샷)


        기본 date range (since/until 생략): 어제~오늘 (2일).


        Native pass-through.'
      operationId: threads_get_user_insights
      parameters:
      - name: threads_user_id
        in: path
        required: true
        schema:
          type: string
          title: Threads User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: metric
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Metric
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: until
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Until
      - name: breakdown
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Breakdown
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)