스레드 수익화의 등급·랭킹·추이·AI 분석을 외부 시스템(엑셀·자동화·자체 대시보드)에서 그대로 가져다 쓰는 인터페이스입니다. 비즈니스 플랜(AI 풀패키지 API) 회원은 마이페이지 → API 키 관리에서 직접 키를 발급합니다.
모든 요청에 발급받은 키를 헤더로 보냅니다. X-API-KEY: thr_xxxxxxxx… (GET 은 ?key= 파라미터도 허용)
키 권한: read=조회(GET)만 · full=조회+실행(POST). 회원 키는 월 3,000회, AI 실행(ai_analyze·fullpack)은 플랜의 월 AI 건수에서 차감됩니다. 한도 초과 시 HTTP 429.
| 메서드·경로 | 파라미터 | 설명 |
|---|---|---|
GET /api/v1/ping | - | 키 유효성·권한 확인 |
GET /api/v1/grade?u=아이디 | u | 팔로워·지수 점수·성장률·전체 순위·티어·스레드캡 레벨 |
GET /api/v1/account?u=아이디&days=30 | u, days(1~365) | 계정 정보 + 기간 팔로워 스냅샷 + 랭크 |
GET /api/v1/list?lv=4&n=50&rand=0 | lv(1~10 팔로워 구간), n(≤500), rand | 한국 활성 계정 목록(지수순 또는 무작위) |
GET /api/v1/ai_get?u=아이디 | u | 최근 AI 분석 결과 조회 |
POST /api/v1/track full | {"username"} | 지금 즉시 수집(팔로워 실측)·추적 등록 |
POST /api/v1/ai_analyze full | {"username","deep":true} | AI 심층/표준 분석 실행(월 건수 차감) |
POST /api/v1/pagegen full | {"username"} | 프로필 카피(tagline·소개) 생성 |
POST /api/v1/fullpack full | {"username","deep":true,"cab":false} | 풀패키지: 수집 → 등급·순위 → AI 분석 → 프로필 카피 (약 30초~1분) |
curl -H "X-API-KEY: thr_xxxx" "https://thread.wordpressdad.com/api/v1/grade?u=worker.cab"
curl -X POST -H "X-API-KEY: thr_xxxx" -H "Content-Type: application/json" -d '{"username":"worker.cab","deep":true}' https://thread.wordpressdad.com/api/v1/fullpack
응답은 JSON(success 필드)이며, 계정을 아직 추적하지 않으면 found:false 또는 404 가 옵니다. 이때 track 을 먼저 호출하세요.
키는 발급 시 한 번만 전체가 표시됩니다. 유출 시 마이페이지에서 비활성화하고 새로 발급하세요. 문의 a@tion.kr