SocQ copriva già profili, video, commenti, ricerca e hashtag pubblici di TikTok; la guida allo scraping di TikTok li illustra. Il 2026-11-17 sono stati attivati altri 14 endpoint TikTok nella pagina della piattaforma TikTok. Rispondono a domande a cui gli endpoint di base non arrivavano: dove vivono i follower di un creator, se le visualizzazioni di un video sono reali, cosa cercano le persone oggi e cosa sta vendendo una LIVE in questo momento.
Questa guida raggruppa i nuovi endpoint per attività, mostra una richiesta per ciascuno, indica il prezzo e spiega quando usarlo.
Risposta rapida: ogni endpoint è una
POSTahttps://api.socq.ai/v1/tiktok/<endpoint>con un corpo JSON. La chiamata restituisce untask_id; interrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.results.items.
I nuovi endpoint TikTok in sintesi
1 credito SocQ = $0.005. Gli endpoint a pagamento per risultato non hanno costo base, quindi un risultato vuoto non costa nulla.
| Endpoint | Cosa restituisce | Prezzo |
|---|---|---|
| TikTok Audience Demographics API | Paesi dei follower con quota e numero campionato | 20 crediti ($0.10) per chiamata |
| TikTok Fake Views Checker API | Punteggio di visualizzazioni false, stima delle visualizzazioni false e quota, fascia di traffico, motivo principale | 5 crediti ($0.025) per chiamata |
| TikTok Similar Accounts API | Account che TikTok consiglia come simili, con bio e conteggi | 0.5 crediti ($0.0025) per account |
| TikTok Reposts API | Video ripubblicati da un account, con autore originale e statistiche | 0.5 crediti ($0.0025) per video |
| TikTok Playlists API | Playlist pubbliche con nome, copertina e numero di video | 0.5 crediti ($0.0025) per playlist |
| TikTok Trending Searches API | Circa 100 ricerche di tendenza di oggi, in classifica | 0.5 crediti ($0.0025) per chiamata |
| TikTok Creator Search Insights API | 20 ricerche popolari con punteggio di popolarità e trend a sette punti | 1 credito ($0.005) per chiamata |
| TikTok Hashtag Views API | Video e visualizzazioni totali per un massimo di 20 hashtag | 0.5 crediti ($0.0025) per hashtag |
| TikTok Comment Keywords API | Parole chiave dei commenti in classifica, con i commenti che le contengono | 1 credito ($0.005) per chiamata |
| TikTok Sound Search API | Suoni con artista, durata, anteprima e numero di utilizzi | 0.6 crediti ($0.003) per suono |
| TikTok Photo Search API | Post a carosello di foto con tutte le immagini e l'engagement | 0.6 crediti ($0.003) per post |
| TikTok Live Search API | LIVE in onda ora, con host, spettatori e like | 0.6 crediti ($0.003) per diretta |
| TikTok Live Ranking API | Fino a 99 host della classifica giornaliera LIVE, con punteggio basato sui regali | 0.5 crediti ($0.0025) per chiamata |
| TikTok Live Shopping API | Prodotti nel carrello di una LIVE, con prezzo e unità vendute | 0.1 crediti ($0.0005) per prodotto |
Autenticazione e flusso asincrono dei task
Tutte le richieste si autenticano con una chiave API. Lo stesso header vale per l'invio, lo stato del task e la lettura dei risultati:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni raccolta viene eseguita come task in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La chiamata di invio risponde subito con data.task_id e data.status. Interroga il task con quell'ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Quando status è succeeded, la risposta include result_count, credits_amount e la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500. Se results.has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Un task fallito contiene error_message.
Puoi aggiungere un callback_url facoltativo a qualsiasi corpo di invio qui sotto. SocQ invia allora una POST con il riepilogo del task quando termina; leggi i record dall'endpoint del task. Un timeout lato client non annulla il task, quindi riprendi con lo stesso ID invece di inviare di nuovo. Un 402 indica che l'account ha esaurito i crediti, e un 429 che la chiave ha raggiunto un limite di frequenza o di crediti.
Verifica un creator prima di pagarlo
Questi cinque endpoint ti aiutano a decidere se un creator vale un accordo.
Audience Demographics elenca ogni paese presente in un campione di follower con la sua quota e il numero di follower campionati, dal più grande. Usalo per verificare che la reach di un creator arrivi nel mercato in cui vendi. username funziona con o senza @. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
Fake Views Checker accetta l'URL di un video o di un post fotografico e restituisce fake_score, is_suspicious, confidence_level, estimated_fake_views, fake_view_percentage, estimated_organic_views, traffic_tier e main_reason. Il parametro facoltativo category (general per impostazione predefinita, oppure entertainment, education, product, verified_large) sceglie i benchmark di engagement. Usalo sui post sponsorizzati e sui creator che stai per pagare per la reach. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Similar Accounts restituisce gli account che TikTok stesso consiglia come simili a uno username, nell'ordine di TikTok, con bio, numero di follower e di video e stato di verifica. Quando un creator funziona per te, questo amplia la shortlist intorno a lui. results_limit vale 30 per impostazione predefinita (da 1 a 300). (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
Reposts mostra cosa amplifica un account oltre ai propri caricamenti: ogni video ripubblicato con autore originale, didascalia, visualizzazioni, like, hashtag e file video, dal più recente. results_limit vale 20 per impostazione predefinita (da 1 a 500). (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
Playlists elenca le playlist pubbliche di un creator con nome, copertina e item_count, così vedi le serie e i formati a cui torna più spesso. results_limit vale 20 per impostazione predefinita (da 1 a 100). (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
Un controllo completo di un creator, con Audience Demographics, Fake Views su tre video recenti e 30 account simili, costa 20 + 15 + 15 = 50 crediti ($0.25).
Scopri cosa cercano e di cosa parlano le persone
Trending Searches non richiede input e restituisce circa 100 ricerche di tendenza di oggi nell'ordine di TikTok, ciascuna con un link di ricerca. L'elenco si aggiorna ogni giorno, quindi è un buon feed mattutino per idee di contenuto. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Creator Search Insights restituisce 20 ricerche popolari, ciascuna con un punteggio di popolarità da 0 a 100, un trend a sette punti, il numero di video correlati, la categoria e le etichette. Tutti i campi sono facoltativi: language (predefinito en; anche ar, de, es, fr, id, ja, ko, pt, th, tr, vi), category (fashion, food, gaming, science, sports, tourism) e filter_by. Imposta filter_by su content_gap per le ricerche con domanda ma ancora pochi video. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
Hashtag Views confronta fino a 20 hashtag in una sola richiesta per numero totale di video e visualizzazioni totali. I tag che non esistono vengono saltati e non addebitati. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
Comment Keywords legge al posto tuo una sezione commenti affollata: le parole chiave più frequenti, in classifica, ciascuna con i commenti che la citano e i relativi like. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Per i termini di ricerca che TikTok mostra sotto una query, consulta la guida a TikTok Top Search.
Cerca suoni e post fotografici
Sound Search cerca nella libreria dei suoni per titolo, artista o mood e restituisce ID del suono, artista, copertina, durata, un'anteprima riproducibile e metrics.videos_count. sort_by può essere relevance (predefinito), most_used o latest; region vale US per impostazione predefinita. Usa l'ID con TikTok Song Videos, oppure confronta con le classifiche nella guida a TikTok Music Chart. results_limit vale 20 per impostazione predefinita (da 1 a 500). (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lofi", "results_limit": 20}'
Photo Search restituisce solo post a carosello di foto, con ogni immagine del carosello più didascalia, autore, hashtag, visualizzazioni, like, commenti e condivisioni. results_limit vale 20 per impostazione predefinita (da 1 a 500). (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
Segui TikTok LIVE e il LIVE Shopping
Live Search trova le dirette in onda al momento della richiesta, con titolo, host, spettatori attuali, like e orario di inizio. results_limit vale 20 per impostazione predefinita (da 1 a 200). (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
Live Shopping elenca i prodotti nel carrello di una diretta con titolo, prezzo attuale, unità vendute, venditore e immagine. L'id e l'author.id di ogni risultato di Live Search sono il room_id e lo user_id che richiede, quindi chiamalo mentre la diretta è ancora in onda. results_limit vale 100 per impostazione predefinita (da 1 a 500), e una diretta senza prodotti non viene addebitata. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
Live Ranking non richiede input e restituisce fino a 99 host della classifica giornaliera LIVE attuale, con posizione, punteggio basato sui regali, username e numero di follower. (documentazione)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Per verificare se account specifici sono in diretta, usa l'endpoint descritto nella guida a TikTok Live Status.
Guide TikTok correlate
Gli annunci e le tariffe dei creator di TikTok Creative Center sono trattati nella guida all'API TikTok Creative Center, e i nuovi endpoint di TikTok Shop nella guida alla ricerca prodotti su TikTok Shop. Per confrontare SocQ con altri fornitori, leggi le 7 migliori API scraper per TikTok e alternative all'API di TikTok.
FAQ
Pago quando un account non ha repost o playlist?
No. Gli endpoint a pagamento per risultato non hanno costo base, e la documentazione specifica che un risultato vuoto non viene addebitato.
Come decide Fake Views Checker cosa è falso?
Confronta l'engagement del video con i benchmark del tipo di contenuto scelto in category e restituisce un punteggio, la stima delle visualizzazioni false e la loro quota, la fascia di traffico e il motivo principale. Consideralo una stima da verificare, non un verdetto.
Da dove vengono room_id e user_id per Live Shopping?
Da TikTok Live Search: l'id di un risultato è il room_id e il suo author.id è lo user_id. La diretta deve essere ancora in corso.
Che differenza c'è tra Trending Searches e Creator Search Insights?
Trending Searches è la classifica di TikTok con circa 100 ricerche di oggi, a 0.5 crediti. Creator Search Insights restituisce 20 ricerche con punteggio di popolarità e trend a sette punti, filtrabili per lingua, categoria e content gap, a 1 credito.
TIKTOK API
Prova il flusso di lavoro con un URL pubblico di TikTok
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di TikTok