Panoramica
Puoi usare l'API Threads per consentire alle persone di creare e pubblicare contenuti per conto di un'altra persona su Threads e per mostrare questi post all'interno della tua app, esclusivamente a chi li ha creati.
L'accesso all'API Threads può essere effettuato da graph.threads.com o graph.threads.net.
Rate limiting
Calls within 24 hours = 4800 * Number of Impressions720000 * number_of_impressions for total_cputime
2880000 * Number of Impressions for total_timePost
I profili Threads sono limitati a 250 post pubblicati dall'API in un periodo mobile di 24 ore. I caroselli vengono considerati come singoli post. Questo limite è applicato all'endpoint POST /{threads-user-id}/threads_publish quando si tenta di pubblicare un contenitore multimediale. Ti consigliamo di configurare l'app in modo che applichi il rate limiting di pubblicazione, soprattutto se consente agli utenti di programmare la pubblicazione futura dei post.
Per controllare l'uso attuale del rate limit dell'API Threads di un profilo, interroga l'endpoint GET /{threads-user-id}/threads_publishing_limit.
Nota: questo endpoint richiede autorizzazioni threads_basic e threads_content_publish.
Campi
| Nome | Descrizione |
|---|---|
| Numero delle pubblicazioni su Threads nelle ultime 24 ore. |
| Oggetto di configurazione del rate limit di pubblicazione di Threads, che contiene i campi |
Richiesta di esempio
curl -s -X GET \ "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"
Risposta di esempio
{
"data": [
{
"quota_usage": 4,
"config": {
"quota_total": 250,
"quota_duration": 86400
}
}
]
}
Risposte
I profili Threads sono limitati a 1000 risposte in un periodo mobile di 24 ore.
Per controllare l'uso attuale del rate limiting per le risposte su Threads di un profilo, invia una query all'endpoint GET /{threads-user-id}/threads_publishing_limit. Consulta la documentazione sulla gestione delle risposte per maggiori informazioni.
Nota: questo endpoint richiede autorizzazioni threads_basic, threads_content_publish e threads_manage_replies.
Campi
| Nome | Descrizione |
|---|---|
| Numero di pubblicazione delle risposte di Threads nelle ultime 24 ore. |
| Oggetto di configurazione del rate limit di pubblicazione delle risposte di Threads, che contiene i campi |
Richiesta di esempio
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>"
Risposta di esempio
{
"data": [
{
"reply_quota_usage": 1,
"reply_config": {
"quota_total": 1000,
"quota_duration": 86400
}
}
]
}
Eliminazione
I profili Threads sono limitati a 100 eliminazioni in un periodo mobile di 24 ore.
Per controllare l'uso attuale del rate limiting per le eliminazioni su Threads di un profilo, invia una query all'endpoint GET /{threads-user-id}/threads_publishing_limit. Consulta la documentazione sull'eliminazione dei post per maggiori informazioni.
Nota: questo endpoint richiede le autorizzazioni threads_basic e threads_delete.
Campi
| Nome | Descrizione |
|---|---|
| Numero di eliminazioni su Threads nelle ultime 24 ore. |
| Oggetto di configurazione del rate limiting per le eliminazioni su Threads, che contiene i campi |
Richiesta di esempio
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>"
Risposta di esempio
{
"data": [
{
"delete_quota_usage": 1,
"delete_config": {
"quota_total": 100,
"quota_duration": 86400
}
}
]
}
Ricerca di luoghi
I profili Threads sono limitati a 500 ricerche di luoghi in un periodo mobile di 24 ore.
Per controllare l'uso attuale del rate limiting per le ricerche di luoghi su Threads di un profilo, invia una query all'endpoint GET /{threads-user-id}/threads_publishing_limit. Consulta la documentazione sulla ricerca di luoghi per maggiori informazioni.
Nota: questo endpoint richiede autorizzazioni threads_basic e threads_location_tagging.
Campi
| Nome | Descrizione |
|---|---|
| Numero delle ricerche di luoghi su Threads nelle ultime 24 ore. |
| Oggetto di configurazione del rate limit di ricerche di luoghi di Threads, che contiene i campi |
Richiesta di esempio
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>"
Risposta di esempio
{
"data": [
{
"location_search_quota_usage": 1,
"location_search_config": {
"quota_total": 500,
"quota_duration": 86400
}
}
]
}
Limitazioni e specifiche
Specifiche delle immagini
- Formato: i tipi di immagini JPEG e PNG sono i formati ufficialmente supportati per i post con immagini.
- Dimensioni del file: massimo 8 MB.
- Limite proporzioni: 10:1
- Larghezza minima: 320 (verrà aumentata al valore minimo se necessario)
- Larghezza massima: 1440 (verrà ridotta al valore massimo se necessario)
- Altezza: varia (a seconda della larghezza e delle proporzioni)
- Spazio colore: sRGB. Le immagini che utilizzano altri spazi colore saranno convertite in sRGB.
Specifiche video
- Contenitore: MOV o MP4 (MPEG-4 Part 14), nessuna lista di modifica, moov atom all'inizio del file.
- Codec audio: AAC, frequenza di campionamento massima di 48 kHz, 1 o 2 canali (mono o stereo)
- Codec video: HEVC o H264, scansione progressiva, GOP chiuso, sottocampionamento cromatico 4:2:0
- Frequenza dei fotogrammi: 23-60 FPS
- Dimensioni dell'immagine:
- Colonne massime (pixel orizzontali): 1920
- Le proporzioni richieste devono essere comprese tra 0,01:1 e 10:1, ma consigliamo proporzioni pari a 9:16 per evitare ritagli o spazi vuoti.
- Bitrate del video: VBR, massimo 100 Mbps.
- Bitrate dell'audio: 128 kbps.
- Durata: massimo 300 secondi (5 minuti) maximum, minimo di durata superiore a 0 secondi.
- Dimensioni del file: massimo 1 GB.
Altre limitazioni
- I post con testo sono limitati a 500 caratteri.
- I post carosello devono avere un massimo di 20 e un minimo di 2 elementi secondari.
- Per ulteriori limitazioni, consulta il riferimento di ogni endpoint.