공개 API
Ankk Threads 공개 API의 기본 주소는
https://threads-api.ankk.app/v1입니다. API 키 사용자가 직접 소유한 계정과
콘텐츠만 다루며, 계정별 작업에는 명시적인 threads_account_id를 사용합니다.
웹 앱에서 이름이 있는 API 키를 생성하세요. 원본 키는 한 번만 표시됩니다. 요청에는 Bearer 토큰으로 전달합니다.
Authorization: Bearer <api-key>API 키는 소유 사용자의 제품 이용 권한을 따르며 요청 사용량과 속도 제한이 적용됩니다. 브라우저 코드, 소스 저장소, 로그에 키를 남기지 마세요.
GET /v1/entitlement에서 현재 요금제, 상태, 구입한 계정 수량과 활성 계정
사용량을 조회할 수 있습니다. 체험이나 구독이 끝난 뒤에도 읽기 endpoint는
사용할 수 있지만, 권한을 복구할 때까지 공급자 동기화와 모든 변경 요청은
fail-closed로 차단합니다.
안전한 변경 요청
섹션 제목: “안전한 변경 요청”게시와 삭제 요청에는 Idempotency-Key 헤더가 필요합니다. 같은 작업에 같은
키를 다시 사용하면 중복 작업을 만들지 않고 기존 canonical job을 반환합니다.
Idempotency-Key: <unique-operation-id>비동기 요청이 접수되었다는 응답은 Threads의 최종 결과가 아닙니다.
/v1/jobs/{job_id}를 조회해 canonical job이 최종 상태에 도달했는지
확인하세요.
미디어 업로드
섹션 제목: “미디어 업로드”POST /v1/uploads는 수명이 짧은 R2 직접 업로드 요청을 반환합니다. 해당
URL로 파일 바이트를 전송한 다음
POST /v1/uploads/{upload_id}/verify를 호출하세요. 검증된 upload ID만
콘텐츠 초안에 연결할 수 있습니다.
리스닝
섹션 제목: “리스닝”/v1/listening/references는 API 키 사용자의 범위에 정확한 Threads 공개
사용자명을 등록합니다. 수집 작업은 명시적으로 선택한 연결 계정을 사용하고
프로필과 게시물 결과를 PostgreSQL에 저장합니다.
/v1/listening/posts는 이 canonical 수집 결과만 검색합니다.
이는 네트워크 전체를 대상으로 하는 자유 키워드 검색이 아니라 Threads
Profile Discovery입니다. 수집 계정에는 threads_profile_discovery 권한이
필요하며 Meta가 허용하는 공개 프로필과 rolling 요청 한도가 적용됩니다.
참조 계정을 삭제하면 수집한 게시물도 함께 삭제됩니다. 수집 계정을 연결
해제하면 새 수집은 중단하지만 사용자의 기존 canonical 이력은 유지합니다.
사용자를 삭제하면 종속 상태가 제거되며, 고객 간 benchmark 저장소로 별도
보존하지 않습니다.
/v1/analytics/accounts와 /v1/analytics/posts는 API 키 사용자가 직접
소유한 연결 계정의 canonical 지표 snapshot을 반환합니다. 수집 요청은
비동기이며 명시적인 UTC 기간과 IANA timezone 이름을 받습니다. 팔로워 수는
Meta가 since와 until을 허용하지 않으므로 기간 지표와 별도로 수집합니다.
OpenAPI 문서가 요청과 응답 형식의 기준입니다. 암호화 자격 증명, Trigger 작업 ID, 공급자 원본 응답, 내부 사용자 ID는 공개 형식에 포함하지 않습니다.