bldinit Threads Rest API
The threads-rest API from bldinit — 15 operation(s) for threads-rest.
The threads-rest API from bldinit — 15 operation(s) for threads-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-threads-rest-api"
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.
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: 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)