TikTokVerifica dei creatorRicerca dei trendTikTok LIVEGuida alle API

Nuovi endpoint dell'API TikTok: pubblico, visualizzazioni false, suoni e LIVE Shopping

14 nuovi endpoint TikTok di SocQ coprono i paesi dei follower, il controllo delle visualizzazioni false, gli account simili, le ricerche di tendenza e i content gap, la ricerca di suoni e foto e i prodotti del LIVE Shopping.

SocQAggiornato il 19 novembre 202610 min di lettura

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 POST a https://api.socq.ai/v1/tiktok/<endpoint> con un corpo JSON. La chiamata restituisce un task_id; interroga GET /v1/tasks/{task_id} finché status non è succeeded, poi leggi data.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.

EndpointCosa restituiscePrezzo
TikTok Audience Demographics APIPaesi dei follower con quota e numero campionato20 crediti ($0.10) per chiamata
TikTok Fake Views Checker APIPunteggio di visualizzazioni false, stima delle visualizzazioni false e quota, fascia di traffico, motivo principale5 crediti ($0.025) per chiamata
TikTok Similar Accounts APIAccount che TikTok consiglia come simili, con bio e conteggi0.5 crediti ($0.0025) per account
TikTok Reposts APIVideo ripubblicati da un account, con autore originale e statistiche0.5 crediti ($0.0025) per video
TikTok Playlists APIPlaylist pubbliche con nome, copertina e numero di video0.5 crediti ($0.0025) per playlist
TikTok Trending Searches APICirca 100 ricerche di tendenza di oggi, in classifica0.5 crediti ($0.0025) per chiamata
TikTok Creator Search Insights API20 ricerche popolari con punteggio di popolarità e trend a sette punti1 credito ($0.005) per chiamata
TikTok Hashtag Views APIVideo e visualizzazioni totali per un massimo di 20 hashtag0.5 crediti ($0.0025) per hashtag
TikTok Comment Keywords APIParole chiave dei commenti in classifica, con i commenti che le contengono1 credito ($0.005) per chiamata
TikTok Sound Search APISuoni con artista, durata, anteprima e numero di utilizzi0.6 crediti ($0.003) per suono
TikTok Photo Search APIPost a carosello di foto con tutte le immagini e l'engagement0.6 crediti ($0.003) per post
TikTok Live Search APILIVE in onda ora, con host, spettatori e like0.6 crediti ($0.003) per diretta
TikTok Live Ranking APIFino a 99 host della classifica giornaliera LIVE, con punteggio basato sui regali0.5 crediti ($0.0025) per chiamata
TikTok Live Shopping APIProdotti nel carrello di una LIVE, con prezzo e unità vendute0.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.

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