개요
Threads API를 사용하여 Threads에서 다른 사람을 대신하여 콘텐츠를 만들고 게시하며, 앱 내의 해당 게시물을 게시물을 만든 사람에게만 표시할 수 있습니다.
Threads API는 graph.threads.com 또는 graph.threads.net을 통해 액세스할 수 있습니다.
사용 제한
Calls within 24 hours = 4800 * Number of Impressions720000 * number_of_impressions for total_cputime
2880000 * Number of Impressions for total_time게시물
Threads 프로필은 24시간 이내에 API를 통해 게시할 수 있는 게시물을 최대 250개로 제한합니다. 슬라이드는 단일 게시물로 간주됩니다. 이 제한은 미디어 컨테이너를 게시하려고 시도할 때 POST /{threads-user-id}/threads_publish 엔드포인트에 적용됩니다. 앱에서도 게시 사용 제한을 적용하는 것이 좋습니다. 특히 앱에서 앱 사용자가 게시물이 나중에 게시되도록 예약할 수 있는 경우에 권장합니다.
프로필의 현재 Threads API 사용 제한 사용량을 확인하려면 GET /{threads-user-id}/threads_publishing_limit 엔드포인트를 쿼리하세요.
참고: 이 엔드포인트는 threads_basic 및 threads_content_publish 권한이 필요합니다.
필드
| 이름 | 설명 |
|---|---|
| 최근 24시간 동안의 Threads 게시 수입니다. |
| Threads 게시 사용 제한 구성 개체이며, 여기에는 |
요청 예시
curl -s -X GET \ "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"
응답 예시
{
"data": [
{
"quota_usage": 4,
"config": {
"quota_total": 250,
"quota_duration": 86400
}
}
]
}
답글
Threads 프로필은 24시간 이내에 달 수 있는 답글을 최대 1,000개로 제한합니다.
프로필의 현재 Threads 답글 사용 제한 사용량을 확인하려면 GET /{threads-user-id}/threads_publishing_limit 엔드포인트를 쿼리하세요. 자세한 내용은 답글 관리 문서를 참조하세요.
참고: 이 엔드포인트는 threads_basic, threads_content_publish 및 threads_manage_replies 권한이 필요합니다.
필드
| 이름 | 설명 |
|---|---|
| 최근 24시간 동안의 Threads 답글 게시 수입니다. |
| Threads 답글 게시 사용 제한 구성 개체이며, 여기에는 |
요청 예시
curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=reply_quota_usage,reply_config&access_token=<ACCESS_TOKEN>"
응답 예시
{
"data": [
{
"reply_quota_usage": 1,
"reply_config": {
"quota_total": 1000,
"quota_duration": 86400
}
}
]
}
삭제
Threads 프로필은 24시간 이내에 삭제할 수 있는 개수를 100개로 제한합니다.
프로필의 현재 Threads 삭제 사용 제한 사용량을 확인하려면 GET /{threads-user-id}/threads_publishing_limit 엔드포인트를 쿼리하세요. 자세한 내용은 게시물 삭제 문서를 참조하세요.
참고: 이 엔드포인트는 threads_basic 및 threads_delete 권한이 필요합니다.
필드
| 이름 | 설명 |
|---|---|
| 최근 24시간 동안의 Threads 삭제 수입니다. |
| Threads 삭제 사용 제한 구성 개체이며, |
요청 예시
curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=delete_quota_usage,delete_config&access_token=<ACCESS_TOKEN>"
응답 예시
{
"data": [
{
"delete_quota_usage": 1,
"delete_config": {
"quota_total": 100,
"quota_duration": 86400
}
}
]
}
위치 검색
Threads 프로필은 24시간 이내의 위치 검색이 500회로 제한됩니다.
프로필의 현재 Threads 위치 검색 사용 제한 사용량을 확인하려면 GET /{threads-user-id}/threads_publishing_limit 엔드포인트를 쿼리하세요. 자세한 내용은 위치 검색 문서를 참조하세요.
참고: 이 엔드포인트는 threads_basic 및 threads_location_tagging 권한이 필요합니다.
필드
| 이름 | 설명 |
|---|---|
| 최근 24시간 동안의 Threads 위치 검색 수입니다. |
| Threads 위치 검색 사용 제한 구성 개체이며, |
요청 예시
curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=location_search_quota_usage,location_search_config&access_token=<ACCESS_TOKEN>"
응답 예시
{
"data": [
{
"location_search_quota_usage": 1,
"location_search_config": {
"quota_total": 500,
"quota_duration": 86400
}
}
]
}
제한 및 사양
이미지 사양
- 형식: JPEG 및 PNG 이미지 유형이 이미지 게시물에 공식적으로 지원되는 형식입니다.
- 파일 크기: 최대 8MB입니다.
- 화면 비율 제한: 10:1
- 최소 너비: 320(필요한 경우 최솟값으로 확대)
- 최대 너비: 1440(필요한 경우 최댓값으로 축소)
- 높이: (너비 및 화면 비율에 따라) 상이
- 컬러 스페이스: sRGB입니다. 다른 컬러 스페이스를 사용하는 이미지는 컬러 스페이스가 sRGB로 전환됩니다.
동영상 사양
- 컨테이너: MOV 또는 MP4(MPEG-4 Part 14). 편집 리스트 없이 moov atom이 파일 맨 앞에 위치해야 합니다.
- 오디오 코덱: AAC, 최대 샘플 속도 48khz, 1 또는 2채널(모노 또는 스테레오)입니다.
- 동영상 코덱: HEVC 또는 H264, 프로그레시브 스캔, 폐쇄 GOP, 4:2:0 크로마 서브샘플링입니다.
- 프레임 속도: 23-60 FPS
- 화면 크기:
- 최대 열(수평 픽셀): 1920
- 필수 화면 비율은 0.01:1~10:1이지만 잘림이나 빈 공간이 생기지 않도록 하려면 9:16을 권장합니다.
- 동영상 비트레이트: VBR, 최대 100Mbps입니다.
- 오디오 비트레이트: 128kbps입니다.
- 지속 시간: 최대 300초(5분), 최소 0초 초과입니다.
- 파일 크기: 최대 1GB입니다.
기타 제한 사항
- 텍스트 게시물은 500자로 제한됩니다.
- 슬라이드 게시물은 하위 항목이 최대 20개, 최소 2개여야 합니다.
- 추가적인 제한 사항은 각 엔드포인트의 참고 자료를 참조하세요.